marble/src

MarbleControlBox Class Reference

#include <MarbleControlBox.h>

Inheritance diagram for MarbleControlBox:

Detailed Description

A widget class that contains advanced controls for a MarbleWidget.

This widget lets the user control an instance of MarbleWidget. The widget contains a ToolBox with 3 pages: a Navigation page with a search tool for cities and other names, a Legend page with a legend for the symbols on the map, and a Map View page with a choice of themes / datasets.

The Navigation page lets the user navigate around the globe by using buttons for panning and a slider for zooming. There is also a "Home" button that lets the user go back to a predefined point at the earth, not unlike the home page in a web browser. In addition there is a search tool that lets the user search for names of points of interest (cities, mountains, glaciers, etc).

The Legend page does not contain any controls, but displays a legend of the symbols that are displayed on the globe.

The Map View page gives the user a choice of different datasets to display, which can also be thought of as different visual themes. The default datasets are a standard Atlas view, a Night view, and a Sattelite view.

See also:: MarbleWidget
MarbleNavigator

Definition at line 73 of file MarbleControlBox.h.


Public Slots
void	changeZoom (int zoom)
void	disableGpsInput (bool)
void	enableFileViewActions ()
void	projectionSelected (int projectionIndex)
void	receiveGpsCoordinates (double, double, GeoDataPoint::Unit)
void	selectProjection (Projection projection)
void	selectTheme (const QString &)
void	setCurrentLocationTabShown (bool show)
void	setFileViewTabShown (bool show)
void	setLegendTabShown (bool show)
void	setMapViewTabShown (bool show)
void	setNavigationTabShown (bool show)
Signals
void	centerOn (const QModelIndex &, bool)
void	goHome ()
void	gpsInputDisabled (bool)
void	gpsPositionChanged (double lat, double lon)
void	moveDown ()
void	moveLeft ()
void	moveRight ()
void	moveUp ()
void	projectionSelected (Projection)
void	selectMapTheme (const QString &)
void	updateGps ()
void	zoomChanged (int zoom)
void	zoomIn ()
void	zoomOut ()
Public Member Functions
void	addMarbleWidget (MarbleWidget *widget)
	MarbleControlBox (QWidget *parent=0)
int	minimumZoom () const
void	setLocations (QAbstractItemModel *locations)
void	setMapThemeModel (QStandardItemModel *model)
	~MarbleControlBox ()
Protected Member Functions
void	resizeEvent (QResizeEvent *)

Constructor & Destructor Documentation

MarbleControlBox::MarbleControlBox ( QWidget * parent = 0 ) [explicit]

Construct a new MarbleControlBox.

Parameters:

parent

the parent widget

Definition at line 69 of file MarbleControlBox.cpp.

MarbleControlBox::~MarbleControlBox ( )

Definition at line 154 of file MarbleControlBox.cpp.

Member Function Documentation

void MarbleControlBox::addMarbleWidget ( MarbleWidget * widget )

Add a MarbleWidget to be controlled by this widget.

Parameters:

widget

the MarbleWidget to be added.

Add a MarbleWidget so that it will be controlled by this widget. This call create all the connections of signals and slots that are necessary to have full control of the MarbleWidget, and thereby frees the programmer from doing it.

Definition at line 196 of file MarbleControlBox.cpp.

void MarbleControlBox::centerOn	(	const QModelIndex &	,
		bool
	)			`[signal]`

Signal emitted when a user selects a placemark in the search widget.

Parameters:

index

the index for the chosen placemark.

This signal is emitted when the user has selected a placemark in the search, e.g. by double clicking it or by pressing return. If it is connected to the centerOn( QModelIndex&) slot in a MarbleWidget, the widget will center the view on this placemark.

void MarbleControlBox::changeZoom ( int zoom ) [slot]

Sets the value of the slider.

Parameters:

zoom

The new zoom value.

This slot should be called when the zoom value is changed from the widget itself, e.g. by using the scroll wheel. It sets the value of the slider, but nothing more. In particular it doesn't emit the zoomChanged signal.

Definition at line 326 of file MarbleControlBox.cpp.

void MarbleControlBox::disableGpsInput ( bool in ) [slot]

Definition at line 334 of file MarbleControlBox.cpp.

void MarbleControlBox::enableFileViewActions ( ) [slot]

Definition at line 393 of file MarbleControlBox.cpp.

void MarbleControlBox::goHome ( ) [signal]

Signal emitted when the Home button has been pressed.

void MarbleControlBox::gpsInputDisabled ( bool ) [signal]

void MarbleControlBox::gpsPositionChanged	(	double	lat,
		double	lon
	)			`[signal]`

int MarbleControlBox::minimumZoom ( ) const

Return the minimum zoom level set in the widget.

Returns:: the minimum zoom level set in the widget.

Definition at line 315 of file MarbleControlBox.cpp.

void MarbleControlBox::moveDown ( ) [signal]

Signal emitted when the Move Down button has been pressed.

void MarbleControlBox::moveLeft ( ) [signal]

Signal emitted when the Move Left button has been pressed.

void MarbleControlBox::moveRight ( ) [signal]

Signal emitted when the Move Right button has been pressed.

void MarbleControlBox::moveUp ( ) [signal]

Signal emitted when the Move Up button has been pressed.

void MarbleControlBox::projectionSelected ( int projectionIndex ) [slot]

Definition at line 529 of file MarbleControlBox.cpp.

void MarbleControlBox::projectionSelected ( Projection ) [signal]

void MarbleControlBox::receiveGpsCoordinates	(	double	x,
		double	y,
		GeoDataPoint::Unit	unit
	)			`[slot]`

Definition at line 357 of file MarbleControlBox.cpp.

void MarbleControlBox::resizeEvent ( QResizeEvent * ) [protected]

Reimplementation of the resizeEvent() of the widget.

If the MarbleControlBox gets shrunk enough, the slider in the Navigation tab will be hidden, leaving only the Zoom Up and Zoom Down buttons.

Reimplemented from QWidget.

Definition at line 446 of file MarbleControlBox.cpp.

void MarbleControlBox::selectMapTheme ( const QString & ) [signal]

void MarbleControlBox::selectProjection ( Projection projection ) [slot]

Definition at line 522 of file MarbleControlBox.cpp.

void MarbleControlBox::selectTheme ( const QString & theme ) [slot]

Definition at line 486 of file MarbleControlBox.cpp.

void MarbleControlBox::setCurrentLocationTabShown ( bool show ) [slot]

Control whether the Current Location tab is shown.

Parameters:

show

boolean that controls if the Current Location tab is shown.

Definition at line 431 of file MarbleControlBox.cpp.

void MarbleControlBox::setFileViewTabShown ( bool show ) [slot]

Control whether the File View tab is shown.

Parameters:

show

boolean that controls if the File View tab is shown.

Definition at line 437 of file MarbleControlBox.cpp.

void MarbleControlBox::setLegendTabShown ( bool show ) [slot]

Control whether the Legend tab is shown.

Parameters:

show

boolean that controls if the Legend tab is shown.

Definition at line 419 of file MarbleControlBox.cpp.

void MarbleControlBox::setLocations ( QAbstractItemModel * locations )

Set a list/set of placemark names for the search widget.

Parameters:

locations

the QAbstractitemModel containing the placemarks

This function is called to display a potentially large number of placemark names in a widget and let the user search between them.

See also:: centerOn

Definition at line 309 of file MarbleControlBox.cpp.

void MarbleControlBox::setMapThemeModel ( QStandardItemModel * model )

Definition at line 159 of file MarbleControlBox.cpp.

void MarbleControlBox::setMapViewTabShown ( bool show ) [slot]

Control whether the Map View tab is shown.

Parameters:

show

boolean that controls if the Map View tab is shown.

Definition at line 425 of file MarbleControlBox.cpp.

void MarbleControlBox::setNavigationTabShown ( bool show ) [slot]

Control whether the Navigation tab is shown.

Parameters:

show

boolean that controls if the Navigation tab is shown.

Definition at line 413 of file MarbleControlBox.cpp.

void MarbleControlBox::updateGps ( ) [signal]

void MarbleControlBox::zoomChanged ( int zoom ) [signal]

Signal emitted when the zoom slider has been moved.

Parameters:

zoom

The new zoom value.

void MarbleControlBox::zoomIn ( ) [signal]

Signal emitted when the Zoom In button has been pressed.

void MarbleControlBox::zoomOut ( ) [signal]

Signal emitted when the Zoom Out button has been pressed.

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

marble/src

MarbleControlBox Class Reference

Detailed Description

Public Slots

Signals

Public Member Functions

Protected Member Functions

Constructor & Destructor Documentation

Member Function Documentation

marble/src

kdeedu