     [Inspectable(category="General")]
     
     /**
-     *  Returns the current number of visible elements.
+     *  The current number of visible elements.
      * 
      *  @default -1
      *  

import spark.layouts.supportClasses.LinearLayoutVector;

/**
 *  The VerticalLayout arranges the layout elements in a vertical sequence,
 *  top to bottom, with optional gaps between the elements and optional padding
 *  around the sequence of elements.
 *
 *  <p>During measure(), the default size of the container is calculated by
 *  accumulating the preferred sizes of the elements, including gaps and padding.
 *  When requestedRowCount is set, only the space for that many elements
 *  will be measured, starting from the first element.</p>
 *
 *  <p>During updateDisplayList(), the height of each element is calculated
 *  according to the following rules, listed in their respective order of
 *  precedence (element's minimum height and maximum height are always respected):
 *  <ul>
 *    <li>If variableRowHeight is false, then set the element's height to the
 *    value of the rowHeight property.</li>
 *
 *    <li>If the element's percentHeight is set, then calculate the element's
 *    height by distributing the available container height between all
 *    elements with percentHeight setting. The available container height
 *    is equal to the container height minus the gaps, the padding and the
 *    space occupied by the rest of the elements. The element's precentHeight
 *    property is ignored when the layout is virtualized.</li>
 *
 *    <li>Set the element's height to its preferred height.</li>
 *  </ul>
 *
 *  The width of each element is calculated according to the following rules,
 *  listed in their respective order of precedence (element's minium width and
 *  maximum width are always respected):
 *  <ul>
 *    <li>If horizontalAlign is "justify" then set the element's width to the
 *    container width.</li>
 *
 *    <li>If horizontalAlign is "contentJustify" then set the element's width
 *    to the maximum between the container's width and all elements' preferred
 *    width.</li>
 *
 *    <li>If the element's percentWidth is set, then calculate the element's
 *    width as a percentage of the container's width.</li>
 *
 *    <li>Set the element's width to its preferred width.</li>
 *  </ul>
 *
 *  The vertical position of the elements is determined by arranging them
 *  in a vertical sequence, top to bottom, taking into account the padding
 *  before the first element and the gaps between the elements.
 *
 *  The horizontal position of the elements is determined by the layout's
 *  horizontalAlign property.</p>
 *
 *  @langversion 3.0
 *  @playerversion Flash 10

     * 
     *  <p>Note that the layout element may only be partially in view.</p>
     * 
     *  @see fractionOfElementInView()
     *  
     *  @langversion 3.0
     *  @playerversion Flash 10
