mirror of
https://github.com/qgis/QGIS.git
synced 2025-04-03 00:05:24 -04:00
f694f75f5d
Temporarily sets a QApplication override cursor for the lifetime of the object, then removes it Makes it easier to ensure that the override is always removed regardless of the exit path taken.
190 lines
7.1 KiB
C++
190 lines
7.1 KiB
C++
/***************************************************************************
|
|
qgsguiutils.h - Constants used throughout the QGIS GUI.
|
|
------------
|
|
Date : 11-Jan-2006
|
|
Copyright : (C) 2006 by Tom Elwertowski
|
|
Email : telwertowski at users dot sourceforge dot net
|
|
***************************************************************************
|
|
* *
|
|
* 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. *
|
|
* *
|
|
***************************************************************************/
|
|
#ifndef QGSGUIUTILS_H
|
|
#define QGSGUIUTILS_H
|
|
|
|
#include <Qt>
|
|
#include <QPair>
|
|
#include <QWidget>
|
|
#include <QStringList>
|
|
#include "qgis_gui.h"
|
|
|
|
#define SIP_NO_FILE
|
|
|
|
class QFont;
|
|
|
|
/**
|
|
* \ingroup gui
|
|
* \namespace QgsGuiUtils
|
|
* The QgsGuiUtils namespace contains constants and helper functions used throughout the QGIS GUI.
|
|
* \note not available in Python bindings
|
|
*/
|
|
namespace QgsGuiUtils
|
|
{
|
|
|
|
/**
|
|
* /var ModalDialogFlags
|
|
* /brief Flags used to create a modal dialog (adapted from QMessageBox).
|
|
*
|
|
* Using these flags for all modal dialogs throughout QGIS ensures that
|
|
* for platforms such as the Mac where modal and modeless dialogs have
|
|
* different looks, QGIS modal dialogs will look the same as Qt modal
|
|
* dialogs and all modal dialogs will look distinct from modeless dialogs.
|
|
* Although not the standard Mac modal look, it does lack the minimize
|
|
* control which makes sense only for modeless dislogs.
|
|
*
|
|
* The Qt3 method of creating a true Mac modal dialog is deprecated in Qt4
|
|
* and should not be used due to conflicts with QMessageBox style dialogs.
|
|
*
|
|
* Qt::WindowMaximizeButtonHint is included but will be ignored if
|
|
* the dialog is a fixed size and does not have a size grip.
|
|
*/
|
|
static const Qt::WindowFlags ModalDialogFlags = nullptr;
|
|
|
|
/**
|
|
* Minimum magnification level allowed in map canvases.
|
|
* \see CANVAS_MAGNIFICATION_MAX
|
|
* \since QGIS 3.0
|
|
*/
|
|
constexpr double CANVAS_MAGNIFICATION_MIN = 0.1;
|
|
|
|
/**
|
|
* Maximum magnification level allowed in map canvases.
|
|
* \see CANVAS_MAGNIFICATION_MAX
|
|
* \since QGIS 3.0
|
|
*/
|
|
// Must be a factor of 2, so zooming in to max from 100% then zooming back out will result in 100% mag
|
|
constexpr double CANVAS_MAGNIFICATION_MAX = 16.0;
|
|
|
|
/**
|
|
Open files, preferring to have the default file selector be the
|
|
last one used, if any; also, prefer to start in the last directory
|
|
associated with filterName.
|
|
|
|
\param filterName the name of the filter; used for persistent store key
|
|
\param filters the file filters used for QFileDialog
|
|
\param selectedFiles string list of selected files; will be empty if none selected
|
|
\param enc encoding?
|
|
\param title the title for the dialog
|
|
\param cancelAll add button to cancel further requests
|
|
\note
|
|
|
|
Stores persistent settings under /UI/. The sub-keys will be
|
|
filterName and filterName + "Dir".
|
|
|
|
Opens dialog on last directory associated with the filter name, or
|
|
the current working directory if this is the first time invoked
|
|
with the current filter name.
|
|
|
|
This method returns true if cancel all was clicked, otherwise false
|
|
*/
|
|
|
|
bool GUI_EXPORT openFilesRememberingFilter( QString const &filterName,
|
|
QString const &filters, QStringList &selectedFiles, QString &enc, QString &title,
|
|
bool cancelAll = false );
|
|
|
|
/**
|
|
* A helper function to get an image name from the user. It will nicely
|
|
* provide filters with all available writable image formats.
|
|
* \param parent widget that should act as the parent for the file dialog
|
|
* \param message the message to display to the user
|
|
* \param defaultFilename default file name (empty by default)
|
|
* \returns QPair<QString, QString> where first is the file name and second is
|
|
* the file type
|
|
*/
|
|
QPair<QString, QString> GUI_EXPORT getSaveAsImageName( QWidget *parent, const QString &message, const QString &defaultFilename = QString() );
|
|
|
|
/**
|
|
Convenience function for readily creating file filters.
|
|
|
|
Given a long name for a file filter and a regular expression, return
|
|
a file filter string suitable for use in a QFileDialog::OpenFiles()
|
|
call. The regular express, glob, will have both all lower and upper
|
|
case versions added.
|
|
*/
|
|
QString GUI_EXPORT createFileFilter_( QString const &longName, QString const &glob );
|
|
|
|
/**
|
|
* Create file filters suitable for use with QFileDialog
|
|
*
|
|
* \param format extension e.g. "png"
|
|
* \returns QString e.g. "PNG format (*.png, *.PNG)"
|
|
*/
|
|
QString GUI_EXPORT createFileFilter_( QString const &format );
|
|
|
|
/**
|
|
* Show font selection dialog.
|
|
*
|
|
* It is strongly recommended that you do not use this method, and instead use the standard
|
|
* QgsFontButton widget to allow users consistent font selection behavior.
|
|
*
|
|
* \param ok true on ok, false on cancel
|
|
* \param initial initial font
|
|
* \param title optional dialog title
|
|
* \returns QFont the selected fon
|
|
*/
|
|
QFont GUI_EXPORT getFont( bool &ok, const QFont &initial, const QString &title = QString() );
|
|
|
|
/**
|
|
* Restore the wigget geometry from settings. Will use the objetName() of the widget and if empty, or keyName is set, will
|
|
* use keyName to save state into settings.
|
|
* \param widget The widget to restore.
|
|
* \param keyName Override for objectName() if needed.
|
|
* \return True if the geometry was restored.
|
|
*/
|
|
bool GUI_EXPORT restoreGeometry( QWidget *widget, const QString &keyName = QString() );
|
|
|
|
/**
|
|
* Save the wigget geometry into settings. Will use the objectName() of the widget and if empty, or keyName is set, will
|
|
* use keyName to save state into settings.
|
|
* \param widget The widget to save.
|
|
* \param keyName Override for objectName() if needed.
|
|
*/
|
|
void GUI_EXPORT saveGeometry( QWidget *widget, const QString &keyName = QString() );
|
|
|
|
/**
|
|
* Creates a key for the given widget that can be used to store related data in settings.
|
|
* Will use objectName() or class name if objectName() is not set. Can be overridden using \a keyName.
|
|
* \param widget The widget to make the key from.
|
|
* \param keyName Override for objectName() if needed. If not set will use objectName()
|
|
* \return A key name that can be used for the widget in settings.
|
|
*/
|
|
QString createWidgetKey( QWidget *widget, const QString &keyName = QString() );
|
|
}
|
|
|
|
/**
|
|
* Temporarily sets a cursor override for the QApplication for the lifetime of the object.
|
|
*
|
|
* When the object is deleted, the cursor override is removed.
|
|
*
|
|
* \ingroup gui
|
|
* \since QGIS 3.2
|
|
*/
|
|
class GUI_EXPORT QgsTemporaryCursorOverride
|
|
{
|
|
public:
|
|
|
|
/**
|
|
* Constructor for QgsTemporaryCursorOverride. Sets the application override
|
|
* cursor to \a cursor.
|
|
*/
|
|
QgsTemporaryCursorOverride( const QCursor &cursor );
|
|
|
|
~QgsTemporaryCursorOverride();
|
|
|
|
};
|
|
|
|
#endif // QGSGUIUTILS_H
|