mirror of
				https://github.com/qgis/QGIS.git
				synced 2025-11-04 00:04:25 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			136 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			136 lines
		
	
	
		
			4.1 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/gui/qgsoptionsdialogbase.h                                       *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 | 
						|
 ************************************************************************/
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
 | 
						|
class QgsOptionsDialogBase : QDialog
 | 
						|
{
 | 
						|
%Docstring
 | 
						|
A base dialog for options and properties dialogs that offers vertical tabs.
 | 
						|
It handles saving/restoring of geometry, splitter and current tab states,
 | 
						|
switching vertical tabs between icon/text to icon-only modes (splitter collapsed to left),
 | 
						|
and connecting QDialogButtonBox's accepted/rejected signals to dialog's accept/reject slots
 | 
						|
 | 
						|
To use:
 | 
						|
1) Start with copy of qgsoptionsdialog_template.ui and build options/properties dialog.
 | 
						|
2) In source file for dialog, inherit this class instead of QDialog, then in constructor:
 | 
						|
...
 | 
						|
setupUi( this ); // set up .ui file objects
 | 
						|
initOptionsBase( ``False`` ); // set up this class to use .ui objects, optionally restoring base ui
 | 
						|
...
 | 
						|
restoreOptionsBaseUi(); // restore the base ui with initOptionsBase or use this later on
 | 
						|
%End
 | 
						|
 | 
						|
%TypeHeaderCode
 | 
						|
#include "qgsoptionsdialogbase.h"
 | 
						|
%End
 | 
						|
  public:
 | 
						|
 | 
						|
    QgsOptionsDialogBase( const QString &settingsKey, QWidget *parent /TransferThis/ = 0, Qt::WindowFlags fl = 0, QgsSettings *settings = 0 );
 | 
						|
%Docstring
 | 
						|
Constructor
 | 
						|
 | 
						|
:param settingsKey: QgsSettings subgroup key for saving/restore ui states, e.g. "ProjectProperties".
 | 
						|
:param parent: parent object (owner)
 | 
						|
:param fl: widget flags
 | 
						|
:param settings: custom QgsSettings pointer
 | 
						|
%End
 | 
						|
    ~QgsOptionsDialogBase();
 | 
						|
 | 
						|
    void initOptionsBase( bool restoreUi = true, const QString &title = QString() );
 | 
						|
%Docstring
 | 
						|
Set up the base ui connections for vertical tabs.
 | 
						|
 | 
						|
:param restoreUi: Whether to restore the base ui at this time.
 | 
						|
:param title: the window title
 | 
						|
%End
 | 
						|
 | 
						|
    void setSettings( QgsSettings *settings );
 | 
						|
 | 
						|
    void restoreOptionsBaseUi( const QString &title = QString() );
 | 
						|
%Docstring
 | 
						|
Restore the base ui.
 | 
						|
Sometimes useful to do at end of subclass's constructor.
 | 
						|
 | 
						|
:param title: the window title (it does not need to be defined if previously given to initOptionsBase();
 | 
						|
%End
 | 
						|
 | 
						|
    void resizeAlltabs( int index );
 | 
						|
%Docstring
 | 
						|
Resizes all tabs when the dialog is resized
 | 
						|
 | 
						|
:param index: current tab index
 | 
						|
 | 
						|
.. versionadded:: 3.10
 | 
						|
%End
 | 
						|
 | 
						|
    bool iconOnly();
 | 
						|
%Docstring
 | 
						|
Determine if the options list is in icon only mode
 | 
						|
%End
 | 
						|
 | 
						|
  public slots:
 | 
						|
 | 
						|
    void searchText( const QString &text );
 | 
						|
%Docstring
 | 
						|
searchText searches for a text in all the pages of the stacked widget and highlight the results
 | 
						|
 | 
						|
:param text: the text to search
 | 
						|
 | 
						|
.. versionadded:: 3.0
 | 
						|
%End
 | 
						|
 | 
						|
  protected slots:
 | 
						|
    virtual void updateOptionsListVerticalTabs();
 | 
						|
%Docstring
 | 
						|
Update tabs on the splitter move
 | 
						|
%End
 | 
						|
    virtual void optionsStackedWidget_CurrentChanged( int index );
 | 
						|
%Docstring
 | 
						|
Select relevant tab on current page change
 | 
						|
%End
 | 
						|
    virtual void optionsStackedWidget_WidgetRemoved( int index );
 | 
						|
%Docstring
 | 
						|
Remove tab and unregister widgets on page remove
 | 
						|
%End
 | 
						|
 | 
						|
    void warnAboutMissingObjects();
 | 
						|
 | 
						|
  protected:
 | 
						|
    virtual void showEvent( QShowEvent *e );
 | 
						|
 | 
						|
    virtual void paintEvent( QPaintEvent *e );
 | 
						|
 | 
						|
 | 
						|
    virtual void updateWindowTitle();
 | 
						|
 | 
						|
    void registerTextSearchWidgets();
 | 
						|
%Docstring
 | 
						|
register widgets in the dialog to search for text in it
 | 
						|
it is automatically called if a line edit has "mSearchLineEdit" as object name.
 | 
						|
 | 
						|
.. versionadded:: 3.0
 | 
						|
%End
 | 
						|
 | 
						|
 | 
						|
};
 | 
						|
 | 
						|
/************************************************************************
 | 
						|
 * This file has been generated automatically from                      *
 | 
						|
 *                                                                      *
 | 
						|
 * src/gui/qgsoptionsdialogbase.h                                       *
 | 
						|
 *                                                                      *
 | 
						|
 * Do not edit manually ! Edit header and run scripts/sipify.pl again   *
 | 
						|
 ************************************************************************/
 |