Dillo v3.1.1-46-g8a360e32
Loading...
Searching...
No Matches
dw::core::DeepIterator Class Reference

A stack of iterators, to iterate recursively through a widget tree. More...

#include <iterator.hh>

Classes

class  Stack
 

Public Member Functions

 DeepIterator (Iterator *it)
 Create a new deep iterator from an existing dw::core::Iterator.
 
 ~DeepIterator ()
 
lout::object::Objectclone ()
 Return an exact copy of the object.
 
DeepIteratorcreateVariant (Iterator *it)
 
IteratorgetTopIterator ()
 
ContentgetContent ()
 
bool isEmpty ()
 
bool next ()
 Move iterator forward and store content it.
 
bool prev ()
 Move iterator backward and store content it.
 
DeepIteratorcloneDeepIterator ()
 
int compareTo (lout::object::Comparable *other)
 Compare two objects, this and other.
 
void highlight (int start, int end, HighlightLayer layer)
 Highlight a part of the current content.
 
void getAllocation (int start, int end, Allocation *allocation)
 Return the shape, which a part of the item, the iterator points on, allocates.
 
void unhighlight (int direction, HighlightLayer layer)
 
- Public Member Functions inherited from lout::object::Object
virtual ~Object ()
 The destructor is defined as virtual (but not abstract), so that destruction of Object's works properly.
 
virtual bool equals (Object *other)
 Returns, whether two objects are equal.
 
virtual int hashValue ()
 Return a hash value for the object.
 
virtual void intoStringBuffer (misc::StringBuffer *sb)
 Store a textual representation of the object in a misc::StringBuffer.
 
const char * toString ()
 Use object::Object::intoStringBuffer to return a textual representation of the object.
 
virtual size_t sizeOf ()
 Return the number of bytes, this object totally uses.
 

Static Public Member Functions

static void scrollTo (DeepIterator *it1, DeepIterator *it2, int start, int end, HPosition hpos, VPosition vpos)
 

Private Member Functions

 DeepIterator ()
 
WidgetgetRespectiveParent (Widget *widget)
 
int getRespectiveLevel (Widget *widget)
 

Static Private Member Functions

static IteratorsearchDownward (Iterator *it, Content::Type mask, bool fromEnd)
 
static IteratorsearchSideward (Iterator *it, Content::Type mask, bool fromEnd)
 
static WidgetgetRespectiveParent (Widget *widget, Content::Type mask)
 
static int getRespectiveLevel (Widget *widget, Content::Type mask)
 

Private Attributes

Stack stack
 
Content::Type mask
 
Content content
 
bool hasContents
 

Detailed Description

A stack of iterators, to iterate recursively through a widget tree.

This class is similar to dw::core::Iterator, but not created by a widget, but explicitly from another iterator. Deep iterators do not have the limitation, that iteration is only done within a widget, instead, child widgets are iterated through recursively.

Definition at line 146 of file iterator.hh.

Constructor & Destructor Documentation

◆ DeepIterator() [1/2]

dw::core::DeepIterator::DeepIterator ( )
inlineprivate

Definition at line 170 of file iterator.hh.

Referenced by dw::core::CharIterator::CharIterator(), clone(), and createVariant().

◆ DeepIterator() [2/2]

dw::core::DeepIterator::DeepIterator ( Iterator it)

Create a new deep iterator from an existing dw::core::Iterator.

The content of the return value will be the content of 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:

  1. The mask of i" must include DW_CONTENT_WIDGET, but dw::core::DeepIterator::next will never return widgets.

Definition at line 497 of file iterator.cc.

References dw::core::Content::ANY_WIDGET, dw::core::Iterator::cloneIterator(), content, dw::core::Iterator::getContent(), dw::core::Iterator::getMask(), getRespectiveLevel(), getRespectiveParent(), dw::core::Iterator::getWidget(), dw::core::Content::getWidget(), hasContents, dw::core::Widget::iterator(), mask, dw::core::Iterator::next(), lout::container::typed::Vector< T >::put(), searchDownward(), searchSideward(), stack, dw::core::Content::type, dw::core::Iterator::unref(), dw::core::Content::WIDGET_OOF_CONT, and dw::core::Content::WIDGET_OOF_REF.

◆ ~DeepIterator()

dw::core::DeepIterator::~DeepIterator ( )

Definition at line 591 of file iterator.cc.

Member Function Documentation

◆ clone()

object::Object * dw::core::DeepIterator::clone ( )
virtual

◆ cloneDeepIterator()

◆ compareTo()

int dw::core::DeepIterator::compareTo ( lout::object::Comparable other)
virtual

Compare two objects, this and other.

Return a value < 0, when this is less than other, a value > 0, when this is greater than other, or 0, when this and other are equal.

If c1.equals(c2) (as defined in Object), c1.compareTo(c2) must be 0, but, unlike you may expect, the reversed is not necessarily true. This method returns 0, if, according to the rules for sorting, there is no difference, but there may still be differences (not relevant for sorting), which "equals" will care about.

Implements lout::object::Comparable.

Definition at line 610 of file iterator.cc.

References lout::container::typed::Vector< T >::get(), lout::container::typed::Collection< T >::size(), and stack.

Referenced by dw::core::SelectionState::adjustSelection(), dw::core::SelectionState::buttonRelease(), dw::core::SelectionState::copy(), dw::core::CharIterator::highlight(), dw::core::SelectionState::highlight0(), dw::core::Iterator::scrollTo(), and dw::core::CharIterator::unhighlight().

◆ createVariant()

DeepIterator * dw::core::DeepIterator::createVariant ( Iterator it)
Todo:
Not yet implemented, and actually not yet needed very much.

Definition at line 656 of file iterator.cc.

References DeepIterator().

Referenced by dw::core::SelectionState::adjustSelection(), and dw::core::SelectionState::switchLinkToSelection().

◆ getAllocation()

void dw::core::DeepIterator::getAllocation ( int  start,
int  end,
Allocation allocation 
)
inline

Return the shape, which a part of the item, the iterator points on, allocates.

The parameters start and end have the same meaning as in DwIterator::highlight().

Definition at line 217 of file iterator.hh.

References dw::core::Iterator::getAllocation(), dw::core::DeepIterator::Stack::getTop(), and stack.

Referenced by dw::core::Iterator::scrollTo().

◆ getContent()

Content * dw::core::DeepIterator::getContent ( )
inline

◆ getRespectiveLevel() [1/2]

int dw::core::DeepIterator::getRespectiveLevel ( Widget widget)
inlineprivate

Definition at line 178 of file iterator.hh.

References getRespectiveLevel(), and mask.

◆ getRespectiveLevel() [2/2]

int dw::core::DeepIterator::getRespectiveLevel ( Widget widget,
Content::Type  mask 
)
staticprivate

◆ getRespectiveParent() [1/2]

Widget * dw::core::DeepIterator::getRespectiveParent ( Widget widget)
inlineprivate

Definition at line 173 of file iterator.hh.

References getRespectiveParent(), and mask.

◆ getRespectiveParent() [2/2]

Widget * dw::core::DeepIterator::getRespectiveParent ( Widget widget,
Content::Type  mask 
)
staticprivate

◆ getTopIterator()

Iterator * dw::core::DeepIterator::getTopIterator ( )
inline

◆ highlight()

void dw::core::DeepIterator::highlight ( int  start,
int  end,
HighlightLayer  layer 
)
inline

Highlight a part of the current content.

Unhighlight the current content by passing -1 as start (see also (dw::core::Iterator::unhighlight). For text, start and end define the characters, otherwise, the shape is defined as [0, 1], i.e. for highlighting a whole dw::core::Content, pass 0 and >= 1.

Definition at line 207 of file iterator.hh.

References dw::core::DeepIterator::Stack::getTop(), dw::core::Iterator::highlight(), and stack.

Referenced by dw::core::SelectionState::adjustSelection(), dw::core::CharIterator::highlight(), and dw::core::SelectionState::highlight0().

◆ isEmpty()

bool dw::core::DeepIterator::isEmpty ( )

Definition at line 662 of file iterator.cc.

References hasContents.

Referenced by dw::core::SelectionState::buttonPress().

◆ next()

◆ prev()

◆ scrollTo()

static void dw::core::DeepIterator::scrollTo ( DeepIterator it1,
DeepIterator it2,
int  start,
int  end,
HPosition  hpos,
VPosition  vpos 
)
inlinestatic

◆ searchDownward()

◆ searchSideward()

◆ unhighlight()

void dw::core::DeepIterator::unhighlight ( int  direction,
HighlightLayer  layer 
)
inline

Member Data Documentation

◆ content

Content dw::core::DeepIterator::content
private

Definition at line 167 of file iterator.hh.

Referenced by clone(), DeepIterator(), getContent(), next(), and prev().

◆ hasContents

bool dw::core::DeepIterator::hasContents
private

Definition at line 168 of file iterator.hh.

Referenced by clone(), DeepIterator(), and isEmpty().

◆ mask

◆ stack

Stack dw::core::DeepIterator::stack
private

The documentation for this class was generated from the following files: