Method DeepIterator

dw/iterator.cc:497–588

* \brief Create a new deep iterator from an existing dw::core::Iterator. * * The content of the return value will be the content of \em it. If within * the widget tree, there is no non-widget content, the resulting deep * iterator is empty (denoted by dw::core::DeepIterator::stack == NULL). * * Notes: * * * The mask of \em i" must include DW_CONTENT_WIDGET, but * dw::core:

 * </ol>
 */
DeepIterator::DeepIterator (Iterator *it)
{
   //printf ("Starting creating DeepIterator %p ...\n", this);
   //printf ("Initial iterator: ");
   //it->print ();
   //printf ("\n");

   // Widgets out of flow are either followed widtin containers, or
   // generators. Both (and also nothing at all) is not allowed. See
   // also comment in getRespectiveParent.
   int oofMask =
      it->getMask() & (Content::WIDGET_OOF_CONT | Content::WIDGET_OOF_REF);
   assert (oofMask == Content::WIDGET_OOF_CONT ||
           oofMask == Content::WIDGET_OOF_REF);

   //DEBUG_MSG (1, "a_Dw_ext_iterator_new: %s\n", a_Dw_iterator_text (it));

   // Clone input iterator, so the iterator passed as parameter
   // remains untouched.
   it = it->cloneIterator ();
   this->mask = it->getMask ();

   hasContents = true;

   // If it points to a widget, find a near non-widget content,
   // since an DeepIterator should never return widgets.
   if (it->getContent()->type & Content::ANY_WIDGET) {
      Iterator *it2;

      // The second argument of searchDownward is actually a matter of
      // taste :-)
      if ((it2 = searchDownward (it, mask, false)) ||
          (it2 = searchSideward (it, mask, false)) ||
          (it2 = searchSideward (it, mask, true))) {
         it->unref ();
         it = it2;
      } else {
         // This may happen, when a page does not contain any non-widget
         // content.
         //DEBUG_MSG (1, "a_Dw_ext_iterator_new got totally helpless!\n");
         it->unref ();
         hasContents = false;
      }
   }

   //DEBUG_MSG (1, "  => %s\n", a_Dw_iterator_text (it));

   if (hasContents) {
      // If this widget has parents, we must construct appropriate iterators.
      //
      // \todo There may be a faster way instead of iterating through the
      //    parent widgets.

      //printf ("Starting with: ");
      //it->print ();
      //printf ("\n");

      // Construct the iterators.