2008-11-23 21:24:58 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
2012-12-28 22:06:43 +00:00
|
|
|
# vim: autoindent shiftwidth=4 expandtab textwidth=120 tabstop=4 softtabstop=4
|
2009-07-14 13:51:27 +00:00
|
|
|
|
2009-09-08 19:58:05 +00:00
|
|
|
###############################################################################
|
|
|
|
# OpenLP - Open Source Lyrics Projection #
|
|
|
|
# --------------------------------------------------------------------------- #
|
2012-12-29 20:56:56 +00:00
|
|
|
# Copyright (c) 2008-2013 Raoul Snyman #
|
|
|
|
# Portions copyright (c) 2008-2013 Tim Bentley, Gerald Britton, Jonathan #
|
2012-06-22 14:14:53 +00:00
|
|
|
# Corwin, Samuel Findlay, Michael Gorven, Scott Guerrieri, Matthias Hub, #
|
2012-11-11 21:16:14 +00:00
|
|
|
# Meinert Jordan, Armin Köhler, Erik Lundin, Edwin Lunando, Brian T. Meyer. #
|
2012-10-21 13:16:22 +00:00
|
|
|
# Joshua Miller, Stevan Pettit, Andreas Preikschat, Mattias Põldaru, #
|
|
|
|
# Christian Richter, Philip Ridout, Simon Scudder, Jeffrey Smith, #
|
|
|
|
# Maikel Stuivenberg, Martin Thompson, Jon Tibble, Dave Warnock, #
|
2012-12-01 07:57:54 +00:00
|
|
|
# Frode Woldsund, Martin Zibricky, Patrick Zimmermann #
|
2009-09-08 19:58:05 +00:00
|
|
|
# --------------------------------------------------------------------------- #
|
|
|
|
# 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; version 2 of the License. #
|
|
|
|
# #
|
|
|
|
# This program is distributed in the hope that it will be useful, but WITHOUT #
|
|
|
|
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or #
|
|
|
|
# FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for #
|
|
|
|
# more details. #
|
|
|
|
# #
|
|
|
|
# You should have received a copy of the GNU General Public License along #
|
|
|
|
# with this program; if not, write to the Free Software Foundation, Inc., 59 #
|
|
|
|
# Temple Place, Suite 330, Boston, MA 02111-1307 USA #
|
|
|
|
###############################################################################
|
2013-02-01 19:58:18 +00:00
|
|
|
"""
|
|
|
|
The :mod:`~openlp.core.lib.settingstab` module contains the base SettingsTab class which plugins use for adding their
|
|
|
|
own tab to the settings dialog.
|
|
|
|
"""
|
2008-11-23 21:24:58 +00:00
|
|
|
|
2009-09-25 00:43:42 +00:00
|
|
|
from PyQt4 import QtGui
|
2009-07-14 13:51:27 +00:00
|
|
|
|
2013-02-01 19:58:18 +00:00
|
|
|
|
2013-02-01 20:09:47 +00:00
|
|
|
from openlp.core.lib import Registry
|
|
|
|
|
2013-03-16 16:59:10 +00:00
|
|
|
|
2009-02-28 23:19:45 +00:00
|
|
|
class SettingsTab(QtGui.QWidget):
|
2009-02-28 07:23:48 +00:00
|
|
|
"""
|
2013-03-16 20:52:59 +00:00
|
|
|
SettingsTab is a helper widget for plugins to define Tabs for the settings dialog.
|
2009-02-28 07:23:48 +00:00
|
|
|
"""
|
2011-04-13 19:12:47 +00:00
|
|
|
def __init__(self, parent, title, visible_title=None, icon_path=None):
|
2009-02-28 07:23:48 +00:00
|
|
|
"""
|
2009-07-10 13:16:15 +00:00
|
|
|
Constructor to create the Settings tab item.
|
|
|
|
|
2010-10-05 16:09:48 +00:00
|
|
|
``title``
|
|
|
|
The title of the tab, which is used internally for the tab handling.
|
|
|
|
|
|
|
|
``visible_title``
|
|
|
|
The title of the tab, which is usually displayed on the tab.
|
2009-02-28 07:23:48 +00:00
|
|
|
"""
|
2011-04-13 19:12:47 +00:00
|
|
|
QtGui.QWidget.__init__(self, parent)
|
2013-03-16 16:59:10 +00:00
|
|
|
self.tab_title = title
|
|
|
|
self.tab_title_visible = visible_title
|
|
|
|
self.settings_section = self.tab_title.lower()
|
2013-03-17 09:21:18 +00:00
|
|
|
self.tab_visited = False
|
2011-04-12 17:45:32 +00:00
|
|
|
if icon_path:
|
2013-03-16 16:59:10 +00:00
|
|
|
self.icon_path = icon_path
|
2009-02-28 23:19:45 +00:00
|
|
|
self.setupUi()
|
|
|
|
self.retranslateUi()
|
2009-05-01 11:50:09 +00:00
|
|
|
self.initialise()
|
2009-03-05 18:16:10 +00:00
|
|
|
self.load()
|
2009-04-15 04:58:51 +00:00
|
|
|
|
2009-02-28 23:19:45 +00:00
|
|
|
def setupUi(self):
|
2009-05-01 11:50:09 +00:00
|
|
|
"""
|
|
|
|
Setup the tab's interface.
|
|
|
|
"""
|
2013-03-16 16:59:10 +00:00
|
|
|
self.tab_layout = QtGui.QHBoxLayout(self)
|
|
|
|
self.tab_layout.setObjectName(u'tab_layout')
|
|
|
|
self.left_column = QtGui.QWidget(self)
|
|
|
|
self.left_column.setObjectName(u'left_column')
|
|
|
|
self.left_layout = QtGui.QVBoxLayout(self.left_column)
|
|
|
|
self.left_layout.setMargin(0)
|
|
|
|
self.left_layout.setObjectName(u'left_layout')
|
|
|
|
self.tab_layout.addWidget(self.left_column)
|
|
|
|
self.right_column = QtGui.QWidget(self)
|
|
|
|
self.right_column.setObjectName(u'right_column')
|
|
|
|
self.right_layout = QtGui.QVBoxLayout(self.right_column)
|
|
|
|
self.right_layout.setMargin(0)
|
|
|
|
self.right_layout.setObjectName(u'right_layout')
|
|
|
|
self.tab_layout.addWidget(self.right_column)
|
2011-01-03 11:25:30 +00:00
|
|
|
|
|
|
|
def resizeEvent(self, event=None):
|
|
|
|
"""
|
|
|
|
Resize the sides in two equal halves if the layout allows this.
|
|
|
|
"""
|
|
|
|
if event:
|
|
|
|
QtGui.QWidget.resizeEvent(self, event)
|
2013-03-16 16:59:10 +00:00
|
|
|
width = self.width() - self.tab_layout.spacing() - \
|
|
|
|
self.tab_layout.contentsMargins().left() - self.tab_layout.contentsMargins().right()
|
|
|
|
left_width = min(width - self.right_column.minimumSizeHint().width(), width / 2)
|
|
|
|
left_width = max(left_width, self.left_column.minimumSizeHint().width())
|
|
|
|
self.left_column.setFixedWidth(left_width)
|
2009-02-28 23:19:45 +00:00
|
|
|
|
|
|
|
def retranslateUi(self):
|
2009-05-01 11:50:09 +00:00
|
|
|
"""
|
|
|
|
Setup the interface translation strings.
|
|
|
|
"""
|
|
|
|
pass
|
|
|
|
|
|
|
|
def initialise(self):
|
|
|
|
"""
|
|
|
|
Do any extra initialisation here.
|
|
|
|
"""
|
2009-02-28 23:19:45 +00:00
|
|
|
pass
|
2009-04-15 04:58:51 +00:00
|
|
|
|
2009-03-01 20:21:57 +00:00
|
|
|
def load(self):
|
2009-05-01 11:50:09 +00:00
|
|
|
"""
|
|
|
|
Load settings from disk.
|
|
|
|
"""
|
2009-03-01 20:21:57 +00:00
|
|
|
pass
|
2009-04-15 04:58:51 +00:00
|
|
|
|
2009-03-01 20:21:57 +00:00
|
|
|
def save(self):
|
2009-05-01 11:50:09 +00:00
|
|
|
"""
|
|
|
|
Save settings to disk.
|
|
|
|
"""
|
2009-03-01 20:21:57 +00:00
|
|
|
pass
|
2009-08-29 07:17:56 +00:00
|
|
|
|
2010-12-23 17:42:28 +00:00
|
|
|
def cancel(self):
|
|
|
|
"""
|
2012-04-02 00:19:16 +00:00
|
|
|
Reset any settings if cancel triggered
|
2010-12-23 17:42:28 +00:00
|
|
|
"""
|
2011-05-15 15:52:20 +00:00
|
|
|
self.load()
|
2010-12-23 17:42:28 +00:00
|
|
|
|
2013-02-19 19:50:14 +00:00
|
|
|
def post_set_up(self, postUpdate=False):
|
2009-08-29 07:17:56 +00:00
|
|
|
"""
|
|
|
|
Changes which need to be made after setup of application
|
2010-12-02 14:37:38 +00:00
|
|
|
|
|
|
|
``postUpdate``
|
|
|
|
Indicates if called before or after updates.
|
|
|
|
|
2009-08-29 07:17:56 +00:00
|
|
|
"""
|
2010-12-27 22:57:35 +00:00
|
|
|
pass
|
2011-12-11 21:59:10 +00:00
|
|
|
|
2013-03-16 16:59:10 +00:00
|
|
|
def tab_visible(self):
|
2011-12-11 21:59:10 +00:00
|
|
|
"""
|
|
|
|
Tab has just been made visible to the user
|
|
|
|
"""
|
2013-03-17 09:21:18 +00:00
|
|
|
self.tab_visited = True
|
2013-02-01 20:09:47 +00:00
|
|
|
|
|
|
|
def _get_service_manager(self):
|
|
|
|
"""
|
|
|
|
Adds the service manager to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_service_manager'):
|
|
|
|
self._service_manager = Registry().get(u'service_manager')
|
|
|
|
return self._service_manager
|
|
|
|
|
|
|
|
service_manager = property(_get_service_manager)
|
|
|
|
|
|
|
|
def _get_main_window(self):
|
|
|
|
"""
|
|
|
|
Adds the main window to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_main_window'):
|
|
|
|
self._main_window = Registry().get(u'main_window')
|
|
|
|
return self._main_window
|
|
|
|
|
|
|
|
main_window = property(_get_main_window)
|
|
|
|
|
|
|
|
def _get_renderer(self):
|
|
|
|
"""
|
|
|
|
Adds the Renderer to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_renderer'):
|
|
|
|
self._renderer = Registry().get(u'renderer')
|
|
|
|
return self._renderer
|
|
|
|
|
|
|
|
renderer = property(_get_renderer)
|
|
|
|
|
|
|
|
def _get_theme_manager(self):
|
|
|
|
"""
|
|
|
|
Adds the theme manager to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_theme_manager'):
|
|
|
|
self._theme_manager = Registry().get(u'theme_manager')
|
|
|
|
return self._theme_manager
|
|
|
|
|
|
|
|
theme_manager = property(_get_theme_manager)
|
|
|
|
|
2013-02-02 07:34:42 +00:00
|
|
|
def _get_media_controller(self):
|
|
|
|
"""
|
|
|
|
Adds the media controller to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_media_controller'):
|
|
|
|
self._media_controller = Registry().get(u'media_controller')
|
|
|
|
return self._media_controller
|
|
|
|
|
|
|
|
media_controller = property(_get_media_controller)
|
2013-02-01 20:09:47 +00:00
|
|
|
|
2013-03-10 20:19:42 +00:00
|
|
|
def _get_settings_form(self):
|
|
|
|
"""
|
|
|
|
Adds the plugin manager to the class dynamically
|
|
|
|
"""
|
|
|
|
if not hasattr(self, u'_settings_form'):
|
|
|
|
self._settings_form = Registry().get(u'settings_form')
|
|
|
|
return self._settings_form
|
|
|
|
|
|
|
|
settings_form = property(_get_settings_form)
|