Envision
A visual programming IDE for object-oriented languages
List of all members | Public Member Functions
Visualization::ShapeFormElement Class Reference

The shape form element is a placeholder form element, stretching to encompass all the available space. More...

Inheritance diagram for Visualization::ShapeFormElement:
Visualization::SuperFormElement< ShapeFormElement, FormElement > Visualization::FormElement

Public Member Functions

 ShapeFormElement ()=default
 
 ShapeFormElement (const ShapeFormElement &)=default
 
virtual ~ShapeFormElement ()
 
virtual ShapeFormElementclone () const override
 Copy this element and all its children into a new element tree. More...
 
virtual void computeSize (Item *item, int availableWidth, int availableHeight) override
 Method called inside the item's updateGeometry method to compute it's size and position it's child elements. More...
 
virtual bool isEmpty (const Item *item) const override
 Method called inside the item's isEmpty method, and by some layout form elements. More...
 
ShapeFormElementoperator= (const ShapeFormElement &)=delete
 
virtual QList< FormElement * > shapeElements () override
 Returns the list of shape elements inside this form element. More...
 
virtual bool sizeDependsOnParent (const Item *item) const override
 Method called inside the item's sizeDependsOnParent method, and by some layout form elements. More...
 
- Public Member Functions inherited from Visualization::SuperFormElement< ShapeFormElement, FormElement >
ShapeFormElementsetBottomMargin (int bottom)
 Sets the bottom margin of this form element. More...
 
ShapeFormElementsetLeftMargin (int left)
 Sets the left margin of this form element. More...
 
ShapeFormElementsetMargins (int left, int top, int right, int bottom)
 Sets the left, top, right and bottom margins to the respective values. More...
 
ShapeFormElementsetMargins (int margin)
 Sets all the margins of this form element to the value specified as margin. More...
 
ShapeFormElementsetRightMargin (int right)
 Sets the right margin of this form element. More...
 
ShapeFormElementsetTopMargin (int top)
 Sets the top margin of this form element. More...
 
- Public Member Functions inherited from Visualization::FormElement
 FormElement ()=default
 
 FormElement (const FormElement &other)
 
virtual ~FormElement ()
 
virtual QList< const Item *const DeclarativeItemBase::* > allHandledChildPointers ()
 Returns a list of all pointer to child items of this form. More...
 
FormElementcloneIfAlreadyUsed ()
 
virtual void destroyChildItems (Item *item, QList< const Item *const DeclarativeItemBase::* > handledChildren)
 This method is recursively called on all form elements to destroy all the information they might have about a specific item. More...
 
virtual bool elementOrChildHasFocus (Item *item) const
 Method called inside the item's elementOrChildHasFocus and by some layout form elements. More...
 
int height (Item *item) const
 Returns the cached height of this form element for the specified item. More...
 
bool isFormRoot () const
 
FormElementoperator= (const FormElement &)=delete
 
FormElementparent () const
 
QPoint pos (Item *item) const
 Returns the cached position of this form element for the specified item. More...
 
virtual QList< ItemRegionregions (DeclarativeItemBase *item, int parentX=0, int parentY=0)
 Method called inside the item's regions method and returns cursor and item regions of all contained form elements for this item. More...
 
FormElementsetBottomMargin (int bottom)
 Sets the bottom margin of this form element. More...
 
FormElementsetFormRoot ()
 Sets this element to be a formRoot. More...
 
virtual void setItemPositions (Item *item, int parentX=0, int parentY=0)
 Method called inside the item's updateGeometry method to recursively position it's child items relative to the item's position. More...
 
FormElementsetLeftMargin (int left)
 Sets the left margin of this form element. More...
 
FormElementsetMargins (int left, int top, int right, int bottom)
 Sets the left, top, right and bottom margins to the respective values. More...
 
FormElementsetMargins (int margin)
 Sets all the margins of this form element to the value specified as margin. More...
 
void setPos (Item *item, const QPoint &position)
 Caches the position of this form element for the specified item. More...
 
FormElementsetRightMargin (int right)
 Sets the right margin of this form element. More...
 
FormElementsetTopMargin (int top)
 Sets the top margin of this form element. More...
 
QSize size (Item *item) const
 Returns the cached size of this form element for the specified item. More...
 
virtual void synchronizeWithItem (Item *item)
 Method called inside the item's determineChildren method to let the form element and it's children update their information about items and nodes belonging to this item. More...
 
int width (Item *item) const
 Returns the cached width of this form element for the specified item. More...
 
int x (Item *item) const
 Returns the cached position on the x-axis of this form element for the specified item. More...
 
int xEnd (Item *item) const
 Returns the cached position on the x-axis where this form element ends for the specified item. More...
 
int y (Item *item) const
 Returns the cached position on the y-axis of this form element for the specified item. More...
 
int yEnd (Item *item) const
 Returns the cached position on the y-axis where this form element ends for the specified item. More...
 

Additional Inherited Members

- Protected Member Functions inherited from Visualization::FormElement
void addChild (FormElement *child)
 Adds a child to the list of children. More...
 
int bottomMargin ()
 Returns the bottom margin. More...
 
const QVector< FormElement * > & children () const
 Returns the list of children. More...
 
int leftMargin ()
 Returns the left margin. More...
 
void removeChild (FormElement *child)
 Removes a child from the list of children. More...
 
int rightMargin ()
 Returns the right margin. More...
 
void setSize (Item *item, const QSize &size)
 Caches the size of this form element for the specified item. More...
 
int topMargin ()
 Returns the top margin. More...
 

Detailed Description

The shape form element is a placeholder form element, stretching to encompass all the available space.

It is used to put the shape at a custom position.

Constructor & Destructor Documentation

◆ ShapeFormElement() [1/2]

Visualization::ShapeFormElement::ShapeFormElement ( )
default

◆ ShapeFormElement() [2/2]

Visualization::ShapeFormElement::ShapeFormElement ( const ShapeFormElement )
default

◆ ~ShapeFormElement()

Visualization::ShapeFormElement::~ShapeFormElement ( )
virtual

Member Function Documentation

◆ clone()

ShapeFormElement * Visualization::ShapeFormElement::clone ( ) const
overridevirtual

Copy this element and all its children into a new element tree.

Implements Visualization::FormElement.

◆ computeSize()

void Visualization::ShapeFormElement::computeSize ( Item item,
int  availableWidth,
int  availableHeight 
)
overridevirtual

Method called inside the item's updateGeometry method to compute it's size and position it's child elements.

The arguments availableWidth and availableHeight are similar to those of Item::updateGeometry. If they are zero, the form element calculates its minimum size, if it they are bigger, the element tries to stretch/grow to this size, but not further.

Implements Visualization::FormElement.

◆ isEmpty()

bool Visualization::ShapeFormElement::isEmpty ( const Item item) const
overridevirtual

Method called inside the item's isEmpty method, and by some layout form elements.

It recursively determines whether the form element is empty for the specified item.

Reimplemented from Visualization::FormElement.

◆ operator=()

ShapeFormElement& Visualization::ShapeFormElement::operator= ( const ShapeFormElement )
delete

◆ shapeElements()

QList< FormElement * > Visualization::ShapeFormElement::shapeElements ( )
overridevirtual

Returns the list of shape elements inside this form element.

Recursively collects the shape elements from the element's children. Method is called once after the static initialization of the visualization item type.

Reimplemented from Visualization::FormElement.

◆ sizeDependsOnParent()

bool Visualization::ShapeFormElement::sizeDependsOnParent ( const Item item) const
overridevirtual

Method called inside the item's sizeDependsOnParent method, and by some layout form elements.

If the form element returns true it can be, that computeSize is called on it a second time with non-zero availableWidth and availableHeight.

Implements Visualization::FormElement.