MAF Tree View

The MAFTreeView component is a graphical control for presenting and editing hierarchical data structures. It provides basic wrapper objects for mapping your hierarchical data into a format that is compatible with an MAF tree view. The wrapper objects also specify linking among the data items, that is, you can use the wrapper objects to define the hierarchical relations of the items you add to the tree view.

The component builds on the MAF reusable simple controls, and is skinnable. Customization of the component’s user interface elements and subviews is dynamic, even at application runtime. MAFTreeView enables device users to:

Navigate through hierarchical data, for example a file system with folders and files, or an organizational structure.
Select elements that are on the same hierarchical level and do not contain lower-level child entries.
Execute different predefined actions on the selected elements. A maximum of three different actions are supported.

Dependencies and Project Setup
MAFTreeView is a complex reusable control, which builds on top of other simple reusable controls, such as MAFUILabel, MAFUIImageView, and MAFUIView. MAFTreeView also uses the skinning infrastructure of the MAFSkinManager, thus it depends on the MAFUIControls library as well.
Preparing Data and Content for the MAF Tree View
The MAF tree view component works with the hierarchical data structure defined by the MAF. This data structure is called MAFTreeContent, and it holds MAFTreeDefaultItem typed objects that can either represent leaf (also known as child) elements or compound/parent elements that hold one or more child elements.
Creating the MAF Tree View Controls
To instantiate the MAFTreeController objects, use the factory C functions declared in the MAFTreeViewFactory.h header file. There are two dedicated functions, both named mafCreateTreeController, separated by their different signatures, for creating the two modes—browsing and editing—of the tree view.
Rebranding the Tree View Component
Use the MAF skinning mechanism to add a custom look and feel to your MAFTreeView.

Parent topic: Developing with iOS Reusable UI Components