class PopUpTreeView

The variant used to style the Button child component in a theme.

To override this default variant, set the PopUpTreeView.customButtonVariant property.

See also:

• PopUpTreeView.customButtonVariant

• feathers.style.IVariantStyleObject.variant

• Feathers UI User Manual: Themes

The variant used to style the TreeView child component in a theme.

To override this default variant, set the PopUpTreeView.customTreeViewVariant property.

See also:

• PopUpTreeView.customTreeViewVariant

• feathers.style.IVariantStyleObject.variant

• Feathers UI User Manual: Themes

Creates a new PopUpTreeView object.

Creates the button, which must be of type feathers.controls.Button.

In the following example, a custom button factory is provided:

popUpTreeView.buttonFactory = () ->
{
	return new Button();
};

See also:

• feathers.controls.Button

A custom variant to set on the button, instead of PopUpTreeView.CHILD_VARIANT_BUTTON.

The customButtonVariant will be not be used if the result of buttonFactory already has a variant set.

See also:

• PopUpTreeView.CHILD_VARIANT_BUTTON

• feathers.style.IVariantStyleObject.variant

A custom variant to set on the pop-up tree view, instead of PopUpTreeView.CHILD_VARIANT_TREE_VIEW.

The customTreeViewVariant will be not be used if the result of treeViewFactory already has a variant set.

See also:

• PopUpTreeView.CHILD_VARIANT_TREE_VIEW

• feathers.style.IVariantStyleObject.variant

The collection of data displayed by the tree view.

Items in the collection must be class instances or anonymous structures. Do not add primitive values (such as strings, booleans, or numeric values) directly to the collection.

Additionally, all items in the collection must be unique object instances. Do not add the same instance to the collection more than once because a runtime exception will be thrown.

The following example passes in a data provider and tells the item renderer how to interpret the data:

var collection = new ArrayHierarchicalCollection([
	{
		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"}
		]
	}
]);
collection.itemToChildren = (item:Dynamic) -> {
	return item.children;
};
popUpTreeView.dataProvider = collection;

popUpTreeView.itemToText = (item:Dynamic) -> {
	return item.text;
};

Manages item renderers used by the pop-up tree view.

In the following example, the pop-up tree view uses a custom item renderer class:

popUpTreeView.itemRendererRecycler = DisplayObjectRecycler.withClass(CustomItemRenderer);

See also:

• feathers.controls.dataRenderers.HierarchicalItemRenderer

• feathers.controls.dataRenderers.LayoutGroupItemRenderer

Indicates if the tree view pop-up is open or closed.

See also:

• PopUpTreeView.openTreeView()

• PopUpTreeView.closeTreeView()

Manages how the tree view is displayed when it is opened and closed.

In the following example, a custom pop-up adapter is provided:

popUpTreeView.popUpAdapter = new DropDownPopUpAdapter();

The text displayed by the button when no item is selected.

The following example sets the pop-up tree view's prompt:

popUpTreeView.prompt = "Select an item";

See also:

• feathers.core.IDataSelector.selectedItem

The currently selected location. Returns null if no location is selected.

The following example selects a specific location:

popUpTreeView.selectedLocation = [2, 0];

The following example clears the currently selected location:

popUpTreeView.selectedLocation = null;

The following example listens for when the selection changes, and it prints the new selected location to the debug console:

var popUpTreeView = new PopUpTreeView();
function changeHandler(event:Event):Void
{
	var popUpTreeView = cast(event.currentTarget, PopUpTreeView);
	trace("selection change: " + popUpTreeView.selectedLocation);
}
popUpTreeView.addEventListener(Event.CHANGE, changeHandler);

Creates the tree view that is displayed as a pop-up. The tree view must be of type feathers.controls.TreeView.

In the following example, a custom tree view factory is provided:

popUpTreeView.treeViewFactory = () ->
{
	return new TreeView();
};

See also:

• feathers.controls.TreeView

Closes the pop-up tree, if it is open.

The following example closes the pop-up tree:

if(popUpTreeView.open)
{
	popUpTreeView.closeTreeView();
}

When the pop-up tree closes, the component will dispatch an event of type Event.CLOSE.

See also:

• PopUpTreeView.open

• PopUpTreeView.openTreeView()

• openfl.events.Event.CLOSE

Determines if an item should be enabled or disabled. By default, all items are enabled, unless the PopUpTreeView is disabled. This method may be replaced to provide a custom value for enabled.

For example, consider the following item:

{ text: "Example Item", disable: true }

If the PopUpTreeView should disable an item if the disable field is true, a custom implementation of itemToEnabled() might look like this:

popUpTreeView.itemToEnabled = (item:Dynamic) -> {
	return !item.disable;
};

Converts an item to text to display within the Button, if the item is selected. By default, the toString() method is called to convert an item to text. This method may be replaced to provide custom text.

For example, consider the following item:

{ text: "Example Item" }

If the Button should display the text "Example Item", a custom implementation of itemToText() might look like this:

popUpTreeView.itemToText = (item:Dynamic) -> {
	return item.text;
};

Opens the pop-up tree, if it is not already open.

The following example opens the pop-up tree:

if(!popUpTreeView.open)
{
	popUpTreeView.openTreeView();
}

When the pop-up tree opens, the component will dispatch an event of type Event.OPEN.

See also:

• PopUpTreeView.open

• PopUpTreeView.closeTreeView()

• openfl.events.Event.OPEN