A collection of convenience factories for creating iterators for widgets. This mostly helps developers support {@link HasWidgets} without having to implement their own {@link Iterator}.

class WidgetIterators {

 /**
  * Wraps an array of widgets to be returned during iteration.
  * <code>null</code> is allowed in the array and will be skipped during
  * iteration.
  *
  * @param container the container of the widgets in <code>contained</code>
  * @param contained the array of widgets
  * @return the iterator
  */
 static Iterator<Widget> createWidgetIterator(HasWidgets container, List<Widget> contained) {
   return new _WidgetsIterator(container, contained);
 }
}