A wizard to edit metadata on a map layer. More...

#include <qgsmetadatawidget.h>

Inheritance diagram for QgsMetadataWidget:

[legend]

Public Types
enum	Mode { LayerMetadata = 0 , ProjectMetadata }
	Widget modes. More...

Public Slots
void	setTitle (const QString &title)
	Sets the title field for the metadata.

Signals
void	titleChanged (const QString &title)
	Emitted when the title field is changed.

Public Member Functions
	QgsMetadataWidget (QWidget parent SIP_TRANSFERTHIS=nullptr, QgsMapLayer layer=nullptr)
	Constructor for the wizard.

void	acceptMetadata ()
	Saves the metadata to the layer.

bool	checkMetadata ()
	Check if values in the wizard are correct.

void	crsChanged ()
	If the CRS is updated.

QgsAbstractMetadataBase *	metadata () SIP_FACTORY
	Returns a QgsAbstractMetadataBase object representing the current state of the widget.

Mode	mode () const
	Returns the widget's current mode.

void	saveMetadata (QgsAbstractMetadataBase *metadata)
	Save all fields in a metadata object.

void	setMapCanvas (QgsMapCanvas *canvas)
	Sets a map canvas associated with the widget.

void	setMetadata (const QgsAbstractMetadataBase *metadata)
	Sets the metadata to display in the widget.

void	setMode (Mode mode)
	Sets the widget's current mode.

QString	title () const
	Returns the current title field for the metadata.

Static Public Member Functions
static QMap< QString, QString >	parseLanguages ()
	Returns a list of languages available by default in the wizard.

static QStringList	parseLicenses ()
	Returns a list of licences available by default in the wizard.

static QStringList	parseLinkTypes ()
	Returns a list of link types available by default in the wizard.

static QStringList	parseMimeTypes ()
	Returns a list of MIME types available by default in the wizard.

static QMap< QString, QString >	parseTypes ()
	Returns a list of types available by default in the wizard.

Properties
QString	title

Detailed Description

A wizard to edit metadata on a map layer.

Definition at line 40 of file qgsmetadatawidget.h.

Member Enumeration Documentation

◆ Mode

enum QgsMetadataWidget::Mode

Widget modes.

Since: QGIS 3.2

Enumerator
LayerMetadata	Show layer metadata.
ProjectMetadata	Show project metadata.

Definition at line 50 of file qgsmetadatawidget.h.

Constructor & Destructor Documentation

◆ QgsMetadataWidget()

QgsMetadataWidget::QgsMetadataWidget	(	QWidget *parent	SIP_TRANSFERTHIS = `nullptr`,
		QgsMapLayer *	layer = `nullptr`
	)

Constructor for the wizard.

If layer is set, then this constructor automatically sets the widget's metadata() to match the layer's metadata..

See also: setMetadata()

Definition at line 35 of file qgsmetadatawidget.cpp.

Member Function Documentation

◆ acceptMetadata()

void QgsMetadataWidget::acceptMetadata ( )

Saves the metadata to the layer.

Definition at line 1032 of file qgsmetadatawidget.cpp.

◆ checkMetadata()

bool QgsMetadataWidget::checkMetadata ( )

Check if values in the wizard are correct.

See also: saveMetadata()

Definition at line 830 of file qgsmetadatawidget.cpp.

◆ crsChanged()

void QgsMetadataWidget::crsChanged ( )

If the CRS is updated.

Definition at line 332 of file qgsmetadatawidget.cpp.

◆ metadata()

QgsAbstractMetadataBase * QgsMetadataWidget::metadata ( )

Returns a QgsAbstractMetadataBase object representing the current state of the widget.

Caller takes ownership of the returned object.

See also: saveMetadata()

Definition at line 211 of file qgsmetadatawidget.cpp.

◆ mode()

Mode QgsMetadataWidget::mode ( ) const

inline

Returns the widget's current mode.

See also: setMode()

Since: QGIS 3.2

Definition at line 78 of file qgsmetadatawidget.h.

◆ parseLanguages()

QMap< QString, QString > QgsMetadataWidget::parseLanguages ( )

static

Returns a list of languages available by default in the wizard.

Definition at line 876 of file qgsmetadatawidget.cpp.

◆ parseLicenses()

QStringList QgsMetadataWidget::parseLicenses ( )

static

Returns a list of licences available by default in the wizard.

Definition at line 919 of file qgsmetadatawidget.cpp.

◆ parseLinkTypes()

QStringList QgsMetadataWidget::parseLinkTypes ( )

static

Returns a list of link types available by default in the wizard.

See also: https://github.com/OSGeo/Cat-Interop/blob/master/LinkPropertyLookupTable.csv

Definition at line 943 of file qgsmetadatawidget.cpp.

◆ parseMimeTypes()

QStringList QgsMetadataWidget::parseMimeTypes ( )

static

Returns a list of MIME types available by default in the wizard.

See also: https://fr.wikipedia.org/wiki/Type_MIME

Definition at line 967 of file qgsmetadatawidget.cpp.

◆ parseTypes()

QMap< QString, QString > QgsMetadataWidget::parseTypes ( )

static

Returns a list of types available by default in the wizard.

Definition at line 989 of file qgsmetadatawidget.cpp.

◆ saveMetadata()

void QgsMetadataWidget::saveMetadata ( QgsAbstractMetadataBase * metadata )

Save all fields in a metadata object.

See also: metadata(); acceptMetadata(); checkMetadata()

Definition at line 690 of file qgsmetadatawidget.cpp.

◆ setMapCanvas()

void QgsMetadataWidget::setMapCanvas ( QgsMapCanvas * canvas )

Sets a map canvas associated with the widget.

Definition at line 1012 of file qgsmetadatawidget.cpp.

◆ setMetadata()

void QgsMetadataWidget::setMetadata ( const QgsAbstractMetadataBase * metadata )

Sets the metadata to display in the widget.

This method can be called after constructing a QgsMetadataWidget in order to set the displayed metadata to custom, non-layer based metadata.

Calling this method will automatically setMode() to the correct mode corresponding to the specified metadata object.

See also: metadata()

Definition at line 197 of file qgsmetadatawidget.cpp.

◆ setMode()

void QgsMetadataWidget::setMode ( QgsMetadataWidget::Mode mode )

Sets the widget's current mode.

See also: mode()

Since: QGIS 3.2

Definition at line 143 of file qgsmetadatawidget.cpp.

◆ setTitle

void QgsMetadataWidget::setTitle ( const QString & title )

slot

Sets the title field for the metadata.

See also: title(); titleChanged()

Since: QGIS 3.2

Definition at line 1023 of file qgsmetadatawidget.cpp.

◆ title()

QString QgsMetadataWidget::title ( ) const

Returns the current title field for the metadata.

See also: setTitle(); titleChanged()

Since: QGIS 3.2

Definition at line 1018 of file qgsmetadatawidget.cpp.

◆ titleChanged

void QgsMetadataWidget::titleChanged ( const QString & title )

signal

Emitted when the title field is changed.

See also: title(); setTitle()

Since: QGIS 3.2

Property Documentation

◆ title

QString QgsMetadataWidget::title

readwrite

Definition at line 43 of file qgsmetadatawidget.h.

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

/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/gui/qgsmetadatawidget.h
/build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/gui/qgsmetadatawidget.cpp

Public Types

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Member Enumeration Documentation

◆ Mode

Constructor & Destructor Documentation

◆ QgsMetadataWidget()

Member Function Documentation

◆ acceptMetadata()

◆ checkMetadata()

◆ crsChanged()

◆ metadata()

◆ mode()

◆ parseLanguages()

◆ parseLicenses()

◆ parseLinkTypes()

◆ parseMimeTypes()

◆ parseTypes()

◆ saveMetadata()

◆ setMapCanvas()

◆ setMetadata()

◆ setMode()

◆ setTitle

◆ title()

◆ titleChanged

Property Documentation

◆ title