 [IconFile("TabNavigator.png")]
 
 /**
- *  The TabNavigator container extends the ViewStack container by including
- *  a TabBar container for navigating between its child containers.
+ *  The Halo TabNavigator container extends the Halo ViewStack container by including
+ *  a TabBar container for navigating between its child Halo containers.
+ * 
+ *  <p><b>Note:</b> The direct children of a Halo navigator container must be 
+ *  Halo containers, either Halo layout or Halo navigator containers. 
+ *  You cannot directly nest a control or a Spark container within a navigator; 
+ *  they must be children of a child Halo container.</p>
  *
  *  <p>Like a ViewStack container, a TabNavigator container has a collection
  *  of child containers, in which only one child at a time is visible.

     */
    protected function get tabBarStyleFilters():Object
    {
    	return _tabBarStyleFilters;
    }
    
    private static var _tabBarStyleFilters:Object =
    {
    	"firstTabStyleName" : "firstTabStyleName",
    	"horizontalAlign" : "horizontalAlign",
    	"horizontalGap" : "horizontalGap",
    	"lastTabStyleName" : "lastTabStyleName",
    	"selectedTabTextStyleName" : "selectedTabTextStyleName",
    	"tabStyleName" : "tabStyleName",
    	"tabWidth" : "tabWidth",
    	"verticalAlign" : "verticalAlign",
    	"verticalGap" : "verticalGap"
    }; 

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

        return tabHeight - borderMetrics.top;
    }

    //----------------------------------
    //  tabBarStyleFilters
    //----------------------------------

