• Skip to content
  • Skip to link menu
KDE API Reference
  • KDE API Reference
  • kdeedu API Reference
  • KDE Home
  • Contact Us
 

marble

  • Marble
  • AbstractDataPluginModel
Public Slots | Signals | Public Member Functions | Protected Member Functions | Properties | List of all members
Marble::AbstractDataPluginModel Class Referenceabstract

#include <AbstractDataPluginModel.h>

Inheritance diagram for Marble::AbstractDataPluginModel:
Inheritance graph
[legend]

Public Slots

void addItemsToList (const QList< AbstractDataPluginItem * > &items)
 
void addItemToList (AbstractDataPluginItem *item)
 
void clear ()
 

Signals

void favoriteItemsChanged (const QStringList &favoriteItems)
 
void favoriteItemsOnlyChanged ()
 
void itemsUpdated ()
 

Public Member Functions

 AbstractDataPluginModel (const QString &name, const MarbleModel *marbleModel, QObject *parent=0)
 
virtual ~AbstractDataPluginModel ()
 
QStringList favoriteItems () const
 
QObject * favoritesModel ()
 
AbstractDataPluginItem * findItem (const QString &id) const
 
bool isFavoriteItemsOnly () const
 
bool itemExists (const QString &id) const
 
QList< AbstractDataPluginItem * > items (const ViewportParams *viewport, qint32 number=10)
 
const MarbleModel * marbleModel () const
 
virtual void setFavoriteItems (const QStringList &list)
 
void setFavoriteItemsOnly (bool favoriteOnly)
 
void setItemSettings (QHash< QString, QVariant > itemSettings)
 
QList< AbstractDataPluginItem * > whichItemAt (const QPoint &curpos)
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
 QObject (QObject *parent, const char *name)
 
virtual  ~QObject ()
 
bool blockSignals (bool block)
 
QObject * child (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
const char * className () const
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
void deleteLater ()
 
void destroyed (QObject *obj)
 
bool disconnect (const QObject *receiver, const char *method)
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
void dumpObjectInfo ()
 
void dumpObjectTree ()
 
QList< QByteArray > dynamicPropertyNames () const
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
T findChild (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QList< T > findChildren (const QString &name) const
 
bool inherits (const char *className) const
 
void insertChild (QObject *object)
 
void installEventFilter (QObject *filterObj)
 
bool isA (const char *className) const
 
bool isWidgetType () const
 
void killTimer (int id)
 
virtual const QMetaObject * metaObject () const
 
void moveToThread (QThread *targetThread)
 
const char * name () const
 
const char * name (const char *defaultName) const
 
QString objectName () const
 
QObject * parent () const
 
QVariant property (const char *name) const
 
void removeChild (QObject *object)
 
void removeEventFilter (QObject *obj)
 
void setName (const char *name)
 
void setObjectName (const QString &name)
 
void setParent (QObject *parent)
 
bool setProperty (const char *name, const QVariant &value)
 
bool signalsBlocked () const
 
int startTimer (int interval)
 
QThread * thread () const
 

Protected Member Functions

void downloadDescriptionFile (const QUrl &url)
 
void downloadItem (const QUrl &url, const QString &type, AbstractDataPluginItem *item)
 
bool fileExists (const QString &fileName) const
 
bool fileExists (const QString &id, const QString &type) const
 
QString generateFilename (const QString &id, const QString &type) const
 
QString generateFilepath (const QString &id, const QString &type) const
 
virtual void getAdditionalItems (const GeoDataLatLonAltBox &box, qint32 number=10)=0
 
virtual void getItem (const QString &id)
 
 MARBLE_DEPRECATED (void downloadItemData(const QUrl &url, const QString &type, AbstractDataPluginItem *item))
 
virtual void parseFile (const QByteArray &file)
 
void registerItemProperties (const QMetaObject &item)
 
- Protected Member Functions inherited from QObject
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
virtual void childEvent (QChildEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void customEvent (QEvent *event)
 
virtual void disconnectNotify (const char *signal)
 
int receivers (const char *signal) const
 
QObject * sender () const
 
int senderSignalIndex () const
 
virtual void timerEvent (QTimerEvent *event)
 

Properties

QObject favoritesModel
 
- Properties inherited from QObject
 objectName
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 

Detailed Description

An abstract data model (not based on QAbstractModel) for a AbstractDataPlugin.

This class is an abstract model for a AbstractDataPlugin. It provides the storage and selection of added items and it is also responsible for downloading item data.

The functions getAdditionalItems() and parseFile() have to be reimplemented in a subclass.

Definition at line 45 of file AbstractDataPluginModel.h.

Constructor & Destructor Documentation

Marble::AbstractDataPluginModel::AbstractDataPluginModel ( const QString &  name,
const MarbleModel *  marbleModel,
QObject *  parent = 0 
)
explicit

Definition at line 247 of file AbstractDataPluginModel.cpp.

Marble::AbstractDataPluginModel::~AbstractDataPluginModel ( )
virtual

Definition at line 264 of file AbstractDataPluginModel.cpp.

Member Function Documentation

void Marble::AbstractDataPluginModel::addItemsToList ( const QList< AbstractDataPluginItem * > &  items)
slot

Adds the items to the list of initialized items.

It checks if items with the same id are already in the list and ignores and deletes them in this case.

Definition at line 408 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::addItemToList ( AbstractDataPluginItem *  item)
slot

Convenience method to add one item to the list.

See addItemsToList

Definition at line 403 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::clear ( )
slot

Removes all items.

Definition at line 663 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::downloadDescriptionFile ( const QUrl &  url)
protected

Download the description file from the url.

Definition at line 392 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::downloadItem ( const QUrl &  url,
const QString &  type,
AbstractDataPluginItem *  item 
)
protected

Downloads the file from url.

item -> addDownloadedFile() will be called when the download is finished.

Parameters
The type of the download (to be specified by the subclasser)

Definition at line 378 of file AbstractDataPluginModel.cpp.

QStringList Marble::AbstractDataPluginModel::favoriteItems ( ) const

Definition at line 478 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::favoriteItemsChanged ( const QStringList &  favoriteItems)
signal
void Marble::AbstractDataPluginModel::favoriteItemsOnlyChanged ( )
signal
QObject* Marble::AbstractDataPluginModel::favoritesModel ( )
bool Marble::AbstractDataPluginModel::fileExists ( const QString &  fileName) const
protected

Testing the existence of the file fileName.

Definition at line 542 of file AbstractDataPluginModel.cpp.

bool Marble::AbstractDataPluginModel::fileExists ( const QString &  id,
const QString &  type 
) const
protected

Testing the existence of a file with id and type.

Definition at line 547 of file AbstractDataPluginModel.cpp.

AbstractDataPluginItem * Marble::AbstractDataPluginModel::findItem ( const QString &  id) const

Finds the item with id in the list.

Returns
The pointer to the item or (if no item has been found) 0

Definition at line 552 of file AbstractDataPluginModel.cpp.

QString Marble::AbstractDataPluginModel::generateFilename ( const QString &  id,
const QString &  type 
) const
protected

Generates the filename relative to the download path from id and type.

Definition at line 527 of file AbstractDataPluginModel.cpp.

QString Marble::AbstractDataPluginModel::generateFilepath ( const QString &  id,
const QString &  type 
) const
protected

Generates the absolute filepath of the from id and type.

Definition at line 537 of file AbstractDataPluginModel.cpp.

virtual void Marble::AbstractDataPluginModel::getAdditionalItems ( const GeoDataLatLonAltBox &  box,
qint32  number = 10 
)
protectedpure virtual

Managing to get number additional items in box.

This includes generating a url and downloading the corresponding file. This method has to be implemented in a subclass.

Implemented in Marble::WeatherModel, Marble::OpenCachingComModel, Marble::PhotoPluginModel, Marble::WikipediaModel, Marble::EarthquakeModel, Marble::OpenDesktopModel, Marble::DeclarativeDataPluginModel, Marble::PanoramioModel, Marble::FoursquareModel, and Marble::PostalCodeModel.

void Marble::AbstractDataPluginModel::getItem ( const QString &  id)
protectedvirtual

Retrieve data for a specific item.

Parameters
idItem id of the item to retrieve

Reimplemented in Marble::WeatherModel.

Definition at line 461 of file AbstractDataPluginModel.cpp.

bool Marble::AbstractDataPluginModel::isFavoriteItemsOnly ( ) const

Definition at line 492 of file AbstractDataPluginModel.cpp.

bool Marble::AbstractDataPluginModel::itemExists ( const QString &  id) const

Testing the existence of the item id in the list.

Definition at line 563 of file AbstractDataPluginModel.cpp.

QList< AbstractDataPluginItem * > Marble::AbstractDataPluginModel::items ( const ViewportParams *  viewport,
qint32  number = 10 
)

Get the items on the viewport Returns the currently downloaded images in the viewport.

The maximum number of images can be specified with number, 0 means no limit.

Returns
The list of item with most important item first.

Definition at line 274 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::itemsUpdated ( )
signal
Marble::AbstractDataPluginModel::MARBLE_DEPRECATED ( void   downloadItemDataconst QUrl &url, const QString &type, AbstractDataPluginItem *item)
protected

Downloads the file from url.

item -> addDownloadedFile() will be called when the download is finished. Additionally initialized() items will be added to the item list after the download. It checks if a item with the same id is already in the list and ignores and deletes the item in this case.

Parameters
The type of the download (to be specified by the subclasser)
Deprecated:
Please use downloadItem() and addItemsToList() for efficiency
const MarbleModel * Marble::AbstractDataPluginModel::marbleModel ( ) const

Definition at line 269 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::parseFile ( const QByteArray &  file)
protectedvirtual

Parse the file and generate items.

The items will be added to the list or the method starts additionally needed downloads. This method has to be implemented in a subclass.

Reimplemented in Marble::WeatherModel, Marble::OpenCachingComModel, Marble::OpenCachingModel, Marble::PhotoPluginModel, Marble::WikipediaModel, Marble::EarthquakeModel, Marble::OpenDesktopModel, Marble::PanoramioModel, Marble::FoursquareModel, and Marble::PostalCodeModel.

Definition at line 364 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::registerItemProperties ( const QMetaObject &  item)
protected

Definition at line 675 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::setFavoriteItems ( const QStringList &  list)
virtual

Reimplemented in Marble::WeatherModel.

Definition at line 466 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::setFavoriteItemsOnly ( bool  favoriteOnly)

Definition at line 483 of file AbstractDataPluginModel.cpp.

void Marble::AbstractDataPluginModel::setItemSettings ( QHash< QString, QVariant >  itemSettings)

Sets the settings for all items.

Sets the settings for all items before painting. This ensures that all items react on changed settings.

Definition at line 568 of file AbstractDataPluginModel.cpp.

QList< AbstractDataPluginItem * > Marble::AbstractDataPluginModel::whichItemAt ( const QPoint &  curpos)

Get all items that contain the given point Returns a list of all items that contain the point curpos.

Definition at line 352 of file AbstractDataPluginModel.cpp.

Property Documentation

QObject * Marble::AbstractDataPluginModel::favoritesModel
read
Todo:
FIXME Qt Quick segfaults if using the real class here instead of QObject

Definition at line 50 of file AbstractDataPluginModel.h.


The documentation for this class was generated from the following files:
  • AbstractDataPluginModel.h
  • AbstractDataPluginModel.cpp
This file is part of the KDE documentation.
Documentation copyright © 1996-2020 The KDE developers.
Generated on Mon Jun 22 2020 13:13:44 by doxygen 1.8.7 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.

marble

Skip menu "marble"
  • Main Page
  • Namespace List
  • Namespace Members
  • Alphabetical List
  • Class List
  • Class Hierarchy
  • Class Members
  • File List
  • File Members
  • Related Pages

kdeedu API Reference

Skip menu "kdeedu API Reference"
  • Analitza
  •     lib
  • kalgebra
  • kalzium
  •   libscience
  • kanagram
  • kig
  •   lib
  • klettres
  • marble
  • parley
  • rocs
  •   App
  •   RocsCore
  •   VisualEditor
  •   stepcore

Search



Report problems with this website to our bug tracking system.
Contact the specific authors with questions and comments about the page contents.

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal