QGIS API Documentation  3.8.0-Zanzibar (11aff65)
Public Member Functions | List of all members
QgsDataItemGuiProvider Class Referenceabstract

Abstract base class for providers which affect how QgsDataItem items behave within the application GUI. More...

#include <qgsdataitemguiprovider.h>

Public Member Functions

virtual ~QgsDataItemGuiProvider ()=default
 
virtual bool handleDoubleClick (QgsDataItem *item, QgsDataItemGuiContext context)
 Called when a user double clicks on an item. More...
 
virtual QString name ()=0
 Returns the provider's name. More...
 
virtual void populateContextMenu (QgsDataItem *item, QMenu *menu, const QList< QgsDataItem *> &selectedItems, QgsDataItemGuiContext context)
 Called when the given context menu is being populated for the given item, allowing the provider to add its own actions and submenus to the context menu. More...
 

Detailed Description

Abstract base class for providers which affect how QgsDataItem items behave within the application GUI.

Providers must be registered via QgsDataItemGuiProviderRegistry.

Since
QGIS 3.6

Definition at line 78 of file qgsdataitemguiprovider.h.

Constructor & Destructor Documentation

◆ ~QgsDataItemGuiProvider()

virtual QgsDataItemGuiProvider::~QgsDataItemGuiProvider ( )
virtualdefault

Member Function Documentation

◆ handleDoubleClick()

bool QgsDataItemGuiProvider::handleDoubleClick ( QgsDataItem item,
QgsDataItemGuiContext  context 
)
virtual

Called when a user double clicks on an item.

Providers should return true if the double-click was handled and do not want other providers to handle the double-click, and to prevent the default double-click behavior for items.

Definition at line 42 of file qgsdataitemguiprovider.cpp.

◆ name()

virtual QString QgsDataItemGuiProvider::name ( )
pure virtual

Returns the provider's name.

◆ populateContextMenu()

void QgsDataItemGuiProvider::populateContextMenu ( QgsDataItem item,
QMenu *  menu,
const QList< QgsDataItem *> &  selectedItems,
QgsDataItemGuiContext  context 
)
virtual

Called when the given context menu is being populated for the given item, allowing the provider to add its own actions and submenus to the context menu.

Additionally, providers could potentially alter menus and actions added by other providers if desired, or use standard QMenu API to insert their items and submenus into the desired location within the context menu.

The selectedItems list contains a list of ALL currently selected items within the browser view. Subclasses can utilize this list in order to create actions which operate on multiple items at once, e.g. to allow deletion of multiple layers from a database at once.

When creating a context menu, this method is called for EVERY QgsDataItemGuiProvider within the QgsDataItemGuiProviderRegistry. It is the QgsDataItemGuiProvider subclass' responsibility to test the item and selectedItems for their properties and classes and decide what actions (if any) are appropriate to add to the context menu.

Care must be taken to correctly parent newly created sub menus and actions to the provided menu to avoid memory leaks.

The context argument gives the wider context under which the context menu is being shown, and contains accessors for useful objects like the application message bar.

The base class method has no effect.

Definition at line 37 of file qgsdataitemguiprovider.cpp.


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