labplot  2.8.2
About: LabPlot is an application for plotting and analysis of 2D and 3D functions and data. It is a complete rewrite of LabPlot1 and lacks in the first release a lot of features available in the predecessor. On the other hand, the GUI and the usability is more superior.
  Fossies Dox: labplot-2.8.2.tar.gz  ("unofficial" and yet experimental doxygen-generated source code documentation)  

Datapicker Class Reference

Top-level container for DatapickerCurve and DatapickerImage. More...

#include <Datapicker.h>

Inheritance diagram for Datapicker:
Collaboration diagram for Datapicker:

Public Slots

void childSelected (const AbstractAspect *) override
- Public Slots inherited from AbstractAspect
bool setName (const QString &, bool autoUnique=true)
 AbstractAspect::setName sets the name of the abstract aspect. More...
void setComment (const QString &)
void remove ()
 Remove me from my parent's list of children. More...


void datapickerItemSelected (int)
void requestUpdateActions ()
- Signals inherited from AbstractPart
void showRequested ()
void importFromFileRequested ()
void importFromSQLDatabaseRequested ()
void exportRequested ()
void printRequested ()
void printPreviewRequested ()
- Signals inherited from AbstractAspect
void aspectDescriptionAboutToChange (const AbstractAspect *)
 Emitted before the name, comment or caption spec is changed. More...
void aspectDescriptionChanged (const AbstractAspect *)
 Emitted after the name, comment or caption spec have changed. More...
void aspectAboutToBeAdded (const AbstractAspect *parent, const AbstractAspect *before, const AbstractAspect *child)
 Emitted before a new child is inserted. More...
void aspectAdded (const AbstractAspect *)
 Emitted after a new Aspect has been added to the tree. More...
void aspectAboutToBeRemoved (const AbstractAspect *)
 Emitted before an aspect is removed from its parent. More...
void aspectRemoved (const AbstractAspect *parent, const AbstractAspect *before, const AbstractAspect *child)
 Emitted from the parent after removing a child. More...
void aspectHiddenAboutToChange (const AbstractAspect *)
 Emitted before the hidden attribute is changed. More...
void aspectHiddenChanged (const AbstractAspect *)
 Emitted after the hidden attribute has changed. More...
void statusInfo (const QString &)
 Emitted whenever some aspect in the tree wants to give status information to the user. More...
void renameRequested ()
void selected (const AbstractAspect *)
void deselected (const AbstractAspect *)
void childAspectSelectedInView (const AbstractAspect *)
void childAspectDeselectedInView (const AbstractAspect *)

Public Member Functions

 Datapicker (const QString &name, const bool loading=false)
 ~Datapicker () override
QIcon icon () const override
QMenu * createContextMenu () override
QWidget * view () const override
 Construct a primary view on me. More...
bool exportView () const override
bool printView () override
bool printPreview () const override
DatapickerCurveactiveCurve ()
SpreadsheetcurrentSpreadsheet () const
DatapickerImageimage () const
void setChildSelectedInView (int index, bool selected)
void setSelectedInView (const bool)
void addNewPoint (QPointF, AbstractAspect *)
QVector3D mapSceneToLogical (QPointF) const
QVector3D mapSceneLengthToLogical (QPointF) const
void save (QXmlStreamWriter *) const override
 Save as XML. More...
bool load (XmlStreamReader *, bool preview) override
 Load from XML. More...
- Public Member Functions inherited from AbstractPart
 AbstractPart (const QString &name, AspectType type)
 ~AbstractPart () override
void deleteView () const
PartMdiViewmdiSubWindow () const
 Wrap the view() into a PartMdiView. More...
bool hasMdiSubWindow () const
bool isDraggable () const override
QVector< AspectTypedropableOn () const override
virtual void registerShortcuts ()
virtual void unregisterShortcuts ()
- Public Member Functions inherited from AbstractAspect
 AbstractAspect (const QString &name, AspectType type)
 ~AbstractAspect () override
QString name () const
QString comment () const
void setCreationTime (const QDateTime &)
QDateTime creationTime () const
virtual Projectproject ()
 Return the Project this Aspect belongs to, or 0 if it is currently not part of one. More...
virtual QString path () const
 Return the path that leads from the top-most Aspect (usually a Project) to me. More...
void setHidden (bool)
 Set "hidden" property, i.e. whether to exclude this aspect from being shown in the explorer. More...
bool hidden () const
void setIsLoading (bool)
bool isLoading () const
AspectType type () const
bool inherits (AspectType type) const
AbstractAspectparentAspect () const
 Return my parent Aspect or 0 if I currently don't have one. More...
AbstractAspectparent (AspectType type) const
 In the parent-child hierarchy, return the first parent of type. More...
void setParentAspect (AbstractAspect *)
Folderfolder ()
 Return the folder the Aspect is contained in or 0 if there is none. More...
bool isDescendantOf (AbstractAspect *other)
 Return whether the there is a path upwards to the given aspect. More...
void addChild (AbstractAspect *)
 Add the given Aspect to my list of children. More...
void addChildFast (AbstractAspect *)
 Add the given Aspect to my list of children without any checks and without putting this step onto the undo-stack. More...
virtual void finalizeAdd ()
QVector< AbstractAspect * > children (AspectType type, ChildIndexFlags flags={}) const
void insertChildBefore (AbstractAspect *child, AbstractAspect *before)
 Insert the given Aspect at a specific position in my list of children. More...
void insertChildBeforeFast (AbstractAspect *child, AbstractAspect *before)
 Insert the given Aspect at a specific position in my list of children.without any checks and without putting this step onto the undo-stack. More...
void reparent (AbstractAspect *newParent, int newIndex=-1)
 Move a child to another parent aspect and transfer ownership. More...
void removeChild (AbstractAspect *)
 Remove the given Aspect from my list of children. More...
void removeAllChildren ()
 Remove all child Aspects. More...
virtual QVector< AbstractAspect * > dependsOn () const
virtual void processDropEvent (const QVector< quintptr > &)
template<class T >
T * ancestor () const
 Return the closest ancestor of class T (or NULL if none found). More...
template<class T >
QVector< T * > children (ChildIndexFlags flags={}) const
template<class T >
T * child (int index, ChildIndexFlags flags={}) const
template<class T >
T * child (const QString &name) const
 Get child by name and class. More...
template<class T >
int childCount (ChildIndexFlags flags={}) const
 Return the number of child Aspects inheriting from given class. More...
template<class T >
int indexOfChild (const AbstractAspect *child, ChildIndexFlags flags={}) const
 Return (0 based) index of child in the list of children inheriting from class T. More...
void setSelected (bool)
void setUndoAware (bool)
virtual QUndoStack * undoStack () const
 Return the undo stack of the Project, or 0 if this Aspect is not part of a Project. More...
void exec (QUndoCommand *)
 Execute the given command, pushing it on the undoStack() if available. More...
void exec (QUndoCommand *command, const char *preChangeSignal, const char *postChangeSignal, QGenericArgument val0=QGenericArgument(), QGenericArgument val1=QGenericArgument(), QGenericArgument val2=QGenericArgument(), QGenericArgument val3=QGenericArgument())
 Execute command and arrange for signals to be sent before/after it is redone or undone. More...
void beginMacro (const QString &text)
 Begin an undo stack macro (series of commands) More...
void endMacro ()
 End the current undo stack macro. More...

Private Slots

void childDeselected (const AbstractAspect *) override
void handleAspectAdded (const AbstractAspect *)
void handleAspectAboutToBeRemoved (const AbstractAspect *)

Private Member Functions

void init ()
void handleChildAspectAboutToBeRemoved (const AbstractAspect *)
void handleChildAspectAdded (const AbstractAspect *)

Private Attributes

DatapickerViewm_view {nullptr}
DatapickerCurvem_activeCurve {nullptr}
DatapickerImagem_image {nullptr}

Additional Inherited Members

- Public Types inherited from AbstractAspect
enum class  ChildIndexFlag { IncludeHidden = 0x01 , Recursive = 0x02 , Compress = 0x04 }
 Flags which control numbering scheme of children. More...
- Protected Slots inherited from AbstractAspect
virtual void childSelected (const AbstractAspect *)
virtual void childDeselected (const AbstractAspect *)
- Protected Member Functions inherited from AbstractAspect
void info (const QString &text)
 Implementations should call this whenever status information should be given to the user. More...
bool readBasicAttributes (XmlStreamReader *)
 Load name and creation time from XML. More...
void writeBasicAttributes (QXmlStreamWriter *) const
 Save name and creation time to XML. More...
void writeCommentElement (QXmlStreamWriter *) const
 Save the comment to XML. More...
bool readCommentElement (XmlStreamReader *)
 Load comment from an XML element. More...
- Protected Attributes inherited from AbstractPart
QWidget * m_partView {nullptr}
- Protected Attributes inherited from AbstractAspect
const AspectType m_type

Detailed Description

Top-level container for DatapickerCurve and DatapickerImage.

A customizable symbol supports error-bars.

File : Datapicker.cpp Project : LabPlot

Description : Datapicker

Copyright : (C) 2015 by Ankit Wagadre ( Copyright : (C) 2015-2019 Alexander Semke (

  • This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. *
  • This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. *
  • You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301 USA *
  • The datapicker-Point is aligned relative to the specified position. The position can be either specified by mouse events or by providing the x- and y- coordinates in parent's coordinate system, or by specifying one of the predefined position flags (HorizontalPosition, VerticalPosition).

Definition at line 45 of file Datapicker.h.

Constructor & Destructor Documentation

◆ Datapicker()

Datapicker::Datapicker ( const QString &  name,
const bool  loading = false 

◆ ~Datapicker()

Datapicker::~Datapicker ( )

Definition at line 57 of file Datapicker.cpp.

References m_transform.

Member Function Documentation

◆ activeCurve()

◆ addNewPoint()

◆ childDeselected

void Datapicker::childDeselected ( const AbstractAspect aspect)

this slot is called when a worksheet element is deselected in the project explorer.

Definition at line 174 of file Datapicker.cpp.

◆ childSelected

void Datapicker::childSelected ( const AbstractAspect aspect)

this slot is called when a datapicker child is selected in the project explorer. emits datapickerItemSelected() to forward this event to the DatapickerView in order to select the corresponding tab.

Definition at line 152 of file Datapicker.cpp.

References AbstractAspect::ancestor(), datapickerItemSelected(), i18n, m_activeCurve, AbstractAspect::name(), requestUpdateActions(), and AbstractAspect::statusInfo().

Referenced by MainWin::activateSubWindowForAspect().

◆ createContextMenu()

QMenu * Datapicker::createContextMenu ( )

Returns a new context menu. The caller takes ownership of the menu.

Reimplemented from AbstractPart.

Definition at line 81 of file Datapicker.cpp.

References AbstractPart::createContextMenu(), DatapickerImage::createContextMenu(), and m_image.

◆ currentSpreadsheet()

Spreadsheet * Datapicker::currentSpreadsheet ( ) const

Definition at line 131 of file Datapicker.cpp.

References DatapickerView::currentIndex(), and m_view.

Referenced by exportView(), printPreview(), and printView().

◆ datapickerItemSelected

void Datapicker::datapickerItemSelected ( int  )

◆ exportView()

bool Datapicker::exportView ( ) const

◆ handleAspectAboutToBeRemoved

void Datapicker::handleAspectAboutToBeRemoved ( const AbstractAspect aspect)

◆ handleAspectAdded

◆ handleChildAspectAboutToBeRemoved()

void Datapicker::handleChildAspectAboutToBeRemoved ( const AbstractAspect aspect)

Definition at line 309 of file Datapicker.cpp.

References m_image, and DatapickerImage::scene().

Referenced by handleAspectAboutToBeRemoved().

◆ handleChildAspectAdded()

void Datapicker::handleChildAspectAdded ( const AbstractAspect aspect)

Definition at line 319 of file Datapicker.cpp.

References m_image, and DatapickerImage::scene().

Referenced by handleAspectAdded().

◆ icon()

QIcon Datapicker::icon ( ) const

Returns an icon to be used in the project explorer.

Reimplemented from AbstractAspect.

Definition at line 74 of file Datapicker.cpp.

◆ image()

DatapickerImage * Datapicker::image ( ) const

Definition at line 143 of file Datapicker.cpp.

References m_image.

Referenced by DatapickerView::createContextMenu(), and DatapickerView::fillToolBar().

◆ init()

void Datapicker::init ( )

◆ load()

◆ mapSceneLengthToLogical()

QVector3D Datapicker::mapSceneLengthToLogical ( QPointF  point) const

Definition at line 261 of file Datapicker.cpp.

References m_image, m_transform, and Transform::mapSceneLengthToLogical().

◆ mapSceneToLogical()

QVector3D Datapicker::mapSceneToLogical ( QPointF  point) const

Definition at line 257 of file Datapicker.cpp.

References m_image, m_transform, and Transform::mapSceneToLogical().

◆ printPreview()

bool Datapicker::printPreview ( ) const

◆ printView()

bool Datapicker::printView ( )

◆ requestUpdateActions

◆ save()

void Datapicker::save ( QXmlStreamWriter *  writer) const

◆ setChildSelectedInView()

void Datapicker::setChildSelectedInView ( int  index,
bool  selected 

Emits the signal to select or to deselect the datapicker item (spreadsheet or image) with the index index in the project explorer, if selected=true or selected=false, respectively. The signal is handled in AspectTreeModel and forwarded to the tree view in ProjectExplorer. This function is called in DatapickerView when the current tab was changed

Definition at line 184 of file Datapicker.cpp.

References AbstractAspect::child(), AbstractAspect::childAspectDeselectedInView(), AbstractAspect::childAspectSelectedInView(), AbstractAspect::children(), AbstractAspect::Recursive, and AbstractAspect::selected().

Referenced by DatapickerView::tabChanged().

◆ setSelectedInView()

void Datapicker::setSelectedInView ( const bool  b)

Selects or deselects the datapicker or its current active curve in the project explorer. This function is called in DatapickerImageView.

Definition at line 224 of file Datapicker.cpp.

References AbstractAspect::childAspectDeselectedInView(), and AbstractAspect::childAspectSelectedInView().

Referenced by DatapickerImageView::mousePressEvent().

◆ view()

QWidget * Datapicker::view ( ) const

Construct a primary view on me.

The caller receives ownership of the view.

This method may be called multiple times during the life time of a Part, or it might not get called at all. Parts must not depend on the existence of a view for their operation.

Implements AbstractPart.

Definition at line 88 of file Datapicker.cpp.

References AbstractPart::m_partView, and m_view.

Referenced by MainWin::updateGUI().

Member Data Documentation

◆ m_activeCurve

DatapickerCurve* Datapicker::m_activeCurve {nullptr}

Definition at line 79 of file Datapicker.h.

Referenced by activeCurve(), childSelected(), and handleAspectAboutToBeRemoved().

◆ m_image

◆ m_transform

Transform* Datapicker::m_transform

Definition at line 80 of file Datapicker.h.

Referenced by mapSceneLengthToLogical(), mapSceneToLogical(), and ~Datapicker().

◆ m_view

DatapickerView* Datapicker::m_view {nullptr}

Definition at line 78 of file Datapicker.h.

Referenced by currentSpreadsheet(), and view().

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