Lumiera  0.pre.03
»edityourfreedom«
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Modules Pages
UICoord Class Reference

#include "gui/interact/ui-coord.hpp"

Description

Describe a location within the UI through structural/topological coordinates.

A UICoord specification is a sequence of Literal tokens, elaborating a path descending through the hierarchy of UI elements down to the specific UI element to refer.

See also
UICoord_test

Definition at line 138 of file ui-coord.hpp.

Public Member Functions

template<typename... ARGS>
 UICoord (ARGS &&...args)
 UI-Coordinates can be created explicitly by specifying a sequence of Literal tokens, which will be used to initialise and then normalise the underlying PathArray. More...
 
 UICoord (UICoord &&)=default
 
 UICoord (UICoord const &)=default
 
 UICoord (UICoord &o)
 
 UICoord (Builder &&builder)
 shortcut to allow init from builder expression More...
 
Builder append (Literal elmID) const
 
string getComp () const
 
Literal getPanel () const
 
string getPath () const
 
Literal getPersp () const
 
Literal getTab () const
 
Literal getView () const
 
Literal getWindow () const
 
bool isComplete () const
 
bool isExplicit () const
 
bool isExtendedBelow (UICoord const &parent) const
 Check if this coordinate spec can be seen as an extension of the given parent coordinates and thus reaches further down towards specific UI elements in comparison to the parent path This constitutes a partial order, since some paths might just be totally unrelated to each other and thus not comparable. More...
 
bool isIncomplete () const
 
bool isPresent (size_t idx) const
 
bool isWildcard (size_t idx) const
 
Builder noTab () const
 
 operator string () const
 
UICoordoperator= (UICoord const &)=default
 
UICoordoperator= (UICoord &&)=default
 
Builder panel (Literal panelID) const
 
Builder path (Literal pathDefinition) const
 convenience builder function so set a full path definition More...
 
iterator pathSeq () const
 iterative access to the path sequence section More...
 
Builder persp (Literal perspectiveID) const
 
Builder prepend (Literal elmID) const
 
Builder rebuild () const
 
Builder tab (Literal tabID) const
 
Builder tab (uint tabIdx) const
 
Builder view (Literal viewID) const
 

Static Public Member Functions

static Builder currentWindow ()
 Builder: start definition of UI-Coordinates rooted in the currentWindow More...
 
static Builder firstWindow ()
 Builder: start definition of UI-Coordinates rooted in the firstWindow More...
 
static Builder window (Literal windowID)
 Builder: start definition of UI-Coordinates rooted in given window. More...
 

Classes

class  Builder
 

Friends

class Builder
 
bool operator!= (UICoord const &l, UICoord const &r)
 
bool operator< (UICoord const &l, UICoord const &r)
 
bool operator<= (UICoord const &l, UICoord const &r)
 
bool operator== (UICoord const &l, UICoord const &r)
 
bool operator> (UICoord const &l, UICoord const &r)
 
bool operator>= (UICoord const &l, UICoord const &r)
 

Private Member Functions

Literal accesComponent (UIPathElm idx) const
 
size_t findStartIdx () const
 
void setComponent (size_t idx, Literal newContent)
 
void setTailSequence (size_t idx, Literal newContent)
 replace / overwrite existing content starting at given index. More...
 
void setTailSequence (size_t idx, std::vector< Literal > &pathElms)
 replace the existing path information with the given elements More...
 

Constructor & Destructor Documentation

UICoord ( ARGS &&...  args)
inlineexplicit

UI-Coordinates can be created explicitly by specifying a sequence of Literal tokens, which will be used to initialise and then normalise the underlying PathArray.

Warning
Literal means _"literal"_ with guaranteed storage during the whole execution.
Remarks
- in case you need to construct some part, then use Symbol to intern the resulting string into the global static SymbolTable.
  • usually the Builder API leads to more readable definitions, explicitly indicating the meaning of the coordinate's parts.

Definition at line 154 of file ui-coord.hpp.

UICoord ( UICoord &&  )
default
UICoord ( UICoord const &  )
default
UICoord ( UICoord o)
inline

Definition at line 158 of file ui-coord.hpp.

UICoord ( Builder &&  builder)
inline

shortcut to allow init from builder expression

Note
this ctor is used to "fix" and normalise the contents established in the Builder thus far.

Definition at line 659 of file ui-coord.hpp.

Member Function Documentation

UICoord& operator= ( UICoord const &  )
default
UICoord& operator= ( UICoord &&  )
default
UICoord::Builder firstWindow ( )
inlinestatic

Builder: start definition of UI-Coordinates rooted in the firstWindow

Definition at line 676 of file ui-coord.hpp.

References UICoord::window().

Referenced by UICoordResolver_test::verify_backingQuery(), UILocationSolver_test::verify_cornerCases(), UICoordResolver_test::verify_mutateAnchor(), UICoordResolver_test::verify_mutateCoverage(), and UICoordResolver_test::verify_queryAnchor().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

UICoord::Builder currentWindow ( )
inlinestatic

Builder: start definition of UI-Coordinates rooted in the currentWindow

Returns
a minimally defined Builder, allowing to define further parts; to finish the definition, cast / store it into UICoord, which itself is immutable.

Definition at line 670 of file ui-coord.hpp.

References UICoord::window().

Referenced by UICoordResolver_test::verify_backingQuery(), UILocationSolver_test::verify_cornerCases(), UICoordResolver_test::verify_mutateAnchor(), UICoordResolver_test::verify_mutateCoverage(), UICoordResolver_test::verify_mutateCoverPartially(), UICoordResolver_test::verify_mutateExtend(), UICoordResolver_test::verify_queryAnchor(), UILocationSolver_test::verify_standardSituations(), and ViewSpecDSL_test::verify_standardUsage().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

UICoord::Builder window ( Literal  windowID)
inlinestatic

Builder: start definition of UI-Coordinates rooted in given window.

Returns
a Builder with just the windowID defined

Definition at line 683 of file ui-coord.hpp.

Referenced by UICoord::currentWindow(), UICoord::firstWindow(), UICoordResolver_test::verify_backingQuery(), UICoord_test::verify_builder(), UILocationSolver_test::verify_cornerCases(), UICoordResolver_test::verify_mutateAnchor(), UICoordResolver_test::verify_mutateCoverage(), UICoordResolver_test::verify_queryAnchor(), and UILocationSolver_test::verify_standardSituations().

+ Here is the caller graph for this function:

UICoord::Builder persp ( Literal  perspectiveID) const
inline
Returns
a Builder holding a clone copy of the original UICoord, with the perspective information set to a new value.
Remarks
This Builder can then be used do set further parts independently of the original. When done, store it as new UICoord object. To achieve real mutation, assign it to the original variable.

Definition at line 696 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoord_test::verify_builder(), UILocationSolver_test::verify_cornerCases(), UICoordResolver_test::verify_mutateCoverage(), UICoordResolver_test::verify_mutateExtend(), and UILocationSolver_test::verify_standardSituations().

+ Here is the caller graph for this function:

UICoord::Builder panel ( Literal  panelID) const
inline

Definition at line 702 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UILocationSolver_test::simple_usage_example(), and UICoordResolver_test::verify_mutateCoverage().

+ Here is the caller graph for this function:

UICoord::Builder view ( Literal  viewID) const
inline

Definition at line 708 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoord_test::verify_builder(), UICoordResolver_test::verify_mutateAnchor(), UICoordResolver_test::verify_mutateCoverage(), UICoordResolver_test::verify_mutateExtend(), and UICoordResolver_test::verify_queryAnchor().

+ Here is the caller graph for this function:

UICoord::Builder tab ( Literal  tabID) const
inline

Definition at line 714 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoordResolver_test::verify_mutateCoverage(), and ViewSpecDSL_test::verify_standardUsage().

+ Here is the caller graph for this function:

UICoord::Builder tab ( uint  tabIdx) const
inline

Definition at line 720 of file ui-coord.hpp.

References UICoord::Builder.

UICoord::Builder noTab ( ) const
inline

Definition at line 726 of file ui-coord.hpp.

References UICoord::Builder.

UICoord::Builder path ( Literal  pathDefinition) const
inline

convenience builder function so set a full path definition

Note
the given path string will be split at `'/'` and the resulting components will be stored/retrieved as Symbol

Definition at line 737 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoord::operator string(), UILocationSolver_test::verify_cornerCases(), and UICoord_test::verify_stringRepr().

+ Here is the caller graph for this function:

UICoord::Builder append ( Literal  elmID) const
inline

Definition at line 743 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoord_test::verify_builder().

+ Here is the caller graph for this function:

UICoord::Builder prepend ( Literal  elmID) const
inline

Definition at line 749 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoord_test::verify_builder().

+ Here is the caller graph for this function:

UICoord::Builder rebuild ( ) const
inline

Definition at line 755 of file ui-coord.hpp.

References UICoord::Builder.

Referenced by UICoordResolver::extend(), and UILocationSolver_test::verify_cornerCases().

+ Here is the caller graph for this function:

Literal getWindow ( ) const
inline

Definition at line 199 of file ui-coord.hpp.

References UICoord::accesComponent(), and gui::interact::UIC_WINDOW.

Referenced by GenNodeLocationQuery::determineAnchor(), UICoord::getComp(), UICoord::isComplete(), UICoord::isIncomplete(), and UICoord_test::verify_builder().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Literal getPersp ( ) const
inline

Definition at line 200 of file ui-coord.hpp.

References UICoord::accesComponent(), and gui::interact::UIC_PERSP.

Referenced by UICoord::getComp(), and UICoord_test::verify_builder().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Literal getPanel ( ) const
inline

Definition at line 201 of file ui-coord.hpp.

References UICoord::accesComponent(), and gui::interact::UIC_PANEL.

Referenced by UICoord::getComp(), and UICoord_test::verify_builder().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Literal getView ( ) const
inline

Definition at line 202 of file ui-coord.hpp.

References UICoord::accesComponent(), and gui::interact::UIC_VIEW.

Referenced by UICoord::getComp(), and UICoord_test::verify_builder().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Literal getTab ( ) const
inline

Definition at line 203 of file ui-coord.hpp.

References UICoord::accesComponent(), and gui::interact::UIC_TAB.

Referenced by UICoord::getComp(), and UICoord_test::verify_builder().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool isIncomplete ( ) const
inline
Remarks
incomplete UI-Coordinates have some fragment of the path defined, but lacks the definition of an anchor point, i.e. it has no window ID

Definition at line 215 of file ui-coord.hpp.

References UICoord::getWindow(), and util::isnil().

Referenced by UICoord::Builder::prepend(), and UICoord_test::verify_localPredicates().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool isComplete ( ) const
inline

Definition at line 222 of file ui-coord.hpp.

References UICoord::getWindow(), and util::isnil().

Referenced by UICoord::isExplicit(), and UICoord_test::verify_localPredicates().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool isExplicit ( ) const
inline
Remarks
an explicit coordinate spec does not use wildcards and is anchored in a window spec

Definition at line 234 of file ui-coord.hpp.

References Symbol::ANY, util::contains(), and UICoord::isComplete().

Referenced by UICoordResolver::attempt_trivialResolution(), UICoordResolver::coverPartially(), and UICoord_test::verify_localPredicates().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool isPresent ( size_t  idx) const
inline

Definition at line 242 of file ui-coord.hpp.

References Symbol::ANY, util::isnil(), and util::unConst().

Referenced by GenNodeLocationQuery::determineAnchor(), GenNodeLocationQuery::drillDown(), UICoordResolver::existentiallyQuantify(), and GenNodeLocationQuery::resolveElm().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool isWildcard ( size_t  idx) const
inline

Definition at line 251 of file ui-coord.hpp.

References Symbol::ANY, and util::unConst().

+ Here is the call graph for this function:

bool isExtendedBelow ( UICoord const &  parent) const
inline

Check if this coordinate spec can be seen as an extension of the given parent coordinates and thus reaches further down towards specific UI elements in comparison to the parent path This constitutes a partial order, since some paths might just be totally unrelated to each other and thus not comparable.

Note
we tolerate (but not demand) expansion/interpolation of the given parent, i.e. parent may be incomplete or contain `'*'` placeholders.
Todo:
10/2017 have to verify suitability of this definition

Definition at line 271 of file ui-coord.hpp.

References Symbol::ANY, ENSURE(), and util::isnil().

+ Here is the call graph for this function:

operator string ( ) const
inlineexplicit

Definition at line 295 of file ui-coord.hpp.

References UICoord::getComp(), UICoord::getPath(), util::isnil(), and UICoord::path().

+ Here is the call graph for this function:

string getComp ( ) const
inline

Definition at line 313 of file ui-coord.hpp.

References UICoord::getPanel(), UICoord::getPersp(), UICoord::getTab(), UICoord::getView(), UICoord::getWindow(), lib::meta::min(), gui::interact::UIC_PANEL, gui::interact::UIC_PATH, gui::interact::UIC_PERSP, gui::interact::UIC_TAB, gui::interact::UIC_VIEW, and gui::interact::UIC_WINDOW.

Referenced by UICoord::operator string(), UICoord_test::verify_builder(), and UICoord_test::verify_stringRepr().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

string getPath ( ) const
inline

Definition at line 354 of file ui-coord.hpp.

References util::isnil(), UICoord::pathSeq(), and gui::interact::UIC_PATH.

Referenced by UICoord::operator string(), UICoord_test::verify_builder(), and UICoord_test::verify_stringRepr().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

iterator pathSeq ( ) const
inline

iterative access to the path sequence section

Definition at line 382 of file ui-coord.hpp.

References gui::interact::UIC_PATH, and util::unConst().

Referenced by UICoord::getPath().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

size_t findStartIdx ( ) const
inlineprivate

Definition at line 394 of file ui-coord.hpp.

Referenced by UICoord::Builder::prepend().

+ Here is the caller graph for this function:

Literal accesComponent ( UIPathElm  idx) const
inlineprivate

Definition at line 401 of file ui-coord.hpp.

References Symbol::EMPTY, and util::unConst().

Referenced by UICoord::getPanel(), UICoord::getPersp(), UICoord::getTab(), UICoord::getView(), and UICoord::getWindow().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void setComponent ( size_t  idx,
Literal  newContent 
)
inlineprivate

Definition at line 408 of file ui-coord.hpp.

Referenced by UICoord::Builder::noTab(), UICoord::Builder::panel(), UICoord::Builder::persp(), UICoord::Builder::prepend(), UICoord::Builder::tab(), UICoord::Builder::view(), and UICoord::Builder::window().

+ Here is the caller graph for this function:

void setTailSequence ( size_t  idx,
Literal  newContent 
)
inlineprivate

replace / overwrite existing content starting at given index.

Parameters
idxwhere to start adding content; storage will be expanded to accommodate
newContenteither a single element, or several elements delimited by `'/' @note - a path sequence will be split at'/'` and the components interned
  • any excess elements will be cleared
Warning
need to invoke PathArray::normalise() afterwards

Definition at line 423 of file ui-coord.hpp.

References util::isnil(), and util::last().

Referenced by UICoord::Builder::append(), and UICoord::Builder::path().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void setTailSequence ( size_t  idx,
std::vector< Literal > &  pathElms 
)
inlineprivate

replace the existing path information with the given elements

Note
- storage will possibly be expanded to accommodate
  • the individual path elements are required to persist
  • any excess elements will be cleared
  • the pathElms can be empty in which case just any content starting from idx will be cleared
Warning
need to invoke PathArray::normalise() afterwards

Definition at line 463 of file ui-coord.hpp.

Friends And Related Function Documentation

friend class Builder
friend
bool operator== ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 478 of file ui-coord.hpp.

bool operator< ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 484 of file ui-coord.hpp.

bool operator> ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 489 of file ui-coord.hpp.

bool operator<= ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 490 of file ui-coord.hpp.

bool operator>= ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 491 of file ui-coord.hpp.

bool operator!= ( UICoord const &  l,
UICoord const &  r 
)
friend

Definition at line 492 of file ui-coord.hpp.

+ Inheritance diagram for UICoord:
+ Collaboration diagram for UICoord:

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