Veronica K. B. Olsen
535 lines
16 KiB
Python
535 lines
16 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""novelWriter Addition QConfigLayout
|
||
|
||
novelWriter – Addition QConfigLayout
|
||
======================================
|
||
A custom Qt grid layout for config forms similar to QFormLayout
|
||
|
||
File History:
|
||
Created: 2020-05-03 [0.4.5] QConfigLayout
|
||
Created: 2020-05-03 [0.4.5] QSwitch
|
||
Created: 2020-05-17 [0.5.1] PagedDialog
|
||
|
||
This file is a part of novelWriter
|
||
Copyright 2018–2020, Veronica Berglyd Olsen
|
||
|
||
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 3 of the License, or
|
||
(at your option) any later version.
|
||
|
||
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, see <https://www.gnu.org/licenses/>.
|
||
"""
|
||
|
||
import nw
|
||
import logging
|
||
|
||
from PyQt5.QtGui import QColor, QPalette, QPainter, QFontMetrics
|
||
from PyQt5.QtCore import (
|
||
Qt, QRect, QPoint, QSize, QRectF, QPropertyAnimation, pyqtProperty
|
||
)
|
||
from PyQt5.QtWidgets import (
|
||
QGridLayout, QLabel, QWidget, QVBoxLayout, QHBoxLayout, QSizePolicy,
|
||
QAbstractButton, QDialog, QTabWidget, QTabBar, QStyle, QDialogButtonBox,
|
||
QStylePainter, QStyleOptionTab, QListWidget, QListWidgetItem, QFrame
|
||
)
|
||
|
||
from nw.constants import nwUnicode, nwQuotes
|
||
|
||
logger = logging.getLogger(__name__)
|
||
|
||
# =============================================================================================== #
|
||
# Config Form Layout
|
||
# =============================================================================================== #
|
||
|
||
class QConfigLayout(QGridLayout):
|
||
|
||
def __init__(self):
|
||
super().__init__()
|
||
|
||
self._nextRow = 0
|
||
self._helpCol = QColor(0, 0, 0)
|
||
self._fontScale = 0.9
|
||
|
||
self._itemMap = {}
|
||
|
||
self.setHorizontalSpacing(8)
|
||
self.setVerticalSpacing(8)
|
||
|
||
return
|
||
|
||
##
|
||
# Getters and Setters
|
||
##
|
||
|
||
def setHelpTextStyle(self, helpCol, fontScale=0.9):
|
||
"""Set the text color for the help text.
|
||
"""
|
||
if isinstance(helpCol, QColor):
|
||
self._helpCol = helpCol
|
||
else:
|
||
self._helpCol = QColor(*helpCol)
|
||
self._fontScale = fontScale
|
||
return
|
||
|
||
def setHelpText(self, intRow, theText):
|
||
"""Set the text for the help label.
|
||
"""
|
||
if intRow in self._itemMap:
|
||
self._itemMap[intRow]["help"].setText(theText)
|
||
return
|
||
|
||
def setLabelText(self, intRow, theText):
|
||
"""Set the text for the main label.
|
||
"""
|
||
if intRow in self._itemMap:
|
||
self._itemMap[intRow]["label"].setText(theText)
|
||
return
|
||
|
||
##
|
||
# Class Methods
|
||
##
|
||
|
||
def addGroupLabel(self, theLabel):
|
||
"""Adds a text label to separate groups of settings.
|
||
"""
|
||
if isinstance(theLabel, QLabel):
|
||
qLabel = theLabel
|
||
elif isinstance(theLabel, str):
|
||
qLabel = QLabel("<b>%s</b>" % theLabel)
|
||
else:
|
||
qLabel = None
|
||
raise ValueError("theLabel must be a QLabel")
|
||
|
||
qLabel.setContentsMargins(0, 4, 0, 4)
|
||
self.addWidget(qLabel, self._nextRow, 0, 1, 2, Qt.AlignLeft)
|
||
|
||
self.setRowStretch(self._nextRow, 0)
|
||
self.setRowStretch(self._nextRow+1, 1)
|
||
|
||
self._nextRow += 1
|
||
|
||
return
|
||
|
||
def addRow(self, theLabel, theWidget, helpText=None, theUnit=None, theButton=None):
|
||
"""Add a label and a widget as a new row of the grid.
|
||
"""
|
||
thisEntry = {
|
||
"label" : None,
|
||
"help" : None,
|
||
"widget" : None,
|
||
}
|
||
|
||
if isinstance(theLabel, QLabel):
|
||
qLabel = theLabel
|
||
elif isinstance(theLabel, str):
|
||
qLabel = QLabel(theLabel)
|
||
else:
|
||
qLabel = None
|
||
raise ValueError("theLabel must be a QLabel")
|
||
|
||
if isinstance(theWidget, QWidget):
|
||
qWidget = theWidget
|
||
else:
|
||
qWidget = None
|
||
raise ValueError("theWidget must be a QWidget")
|
||
|
||
qLabel.setIndent(8)
|
||
if helpText is not None:
|
||
qHelp = QHelpLabel(str(helpText), self._helpCol, self._fontScale)
|
||
qHelp.setIndent(8)
|
||
|
||
labelBox = QVBoxLayout()
|
||
labelBox.addWidget(qLabel)
|
||
labelBox.addWidget(qHelp)
|
||
labelBox.setSpacing(0)
|
||
|
||
thisEntry["help"] = qHelp
|
||
self.addLayout(labelBox, self._nextRow, 0, 1, 1, Qt.AlignLeft | Qt.AlignTop)
|
||
|
||
else:
|
||
self.addWidget(qLabel, self._nextRow, 0, 1, 1, Qt.AlignLeft | Qt.AlignTop)
|
||
|
||
if theUnit is not None:
|
||
controlBox = QHBoxLayout()
|
||
controlBox.addWidget(qWidget, 0, Qt.AlignVCenter)
|
||
controlBox.addWidget(QLabel(theUnit), 0, Qt.AlignVCenter)
|
||
controlBox.setSpacing(8)
|
||
self.addLayout(controlBox, self._nextRow, 1, 1, 1, Qt.AlignRight | Qt.AlignVCenter)
|
||
elif theButton is not None:
|
||
controlBox = QHBoxLayout()
|
||
controlBox.addWidget(qWidget, 0, Qt.AlignVCenter)
|
||
controlBox.addWidget(theButton, 0, Qt.AlignVCenter)
|
||
controlBox.setSpacing(8)
|
||
self.addLayout(controlBox, self._nextRow, 1, 1, 1, Qt.AlignRight | Qt.AlignVCenter)
|
||
else:
|
||
self.addWidget(qWidget, self._nextRow, 1, 1, 1, Qt.AlignRight | Qt.AlignVCenter)
|
||
|
||
qLabel.setBuddy(qWidget)
|
||
|
||
self.setRowStretch(self._nextRow, 0)
|
||
self.setRowStretch(self._nextRow+1, 1)
|
||
|
||
thisEntry["label"] = qLabel
|
||
thisEntry["widget"] = qWidget
|
||
|
||
self._itemMap[self._nextRow] = thisEntry
|
||
|
||
self._nextRow += 1
|
||
|
||
return self._nextRow - 1
|
||
|
||
# END Class QConfigLayout
|
||
|
||
class QHelpLabel(QLabel):
|
||
|
||
def __init__(self, theText, textCol, fontSize=0.9):
|
||
QLabel.__init__(self, theText)
|
||
|
||
if isinstance(textCol, QColor):
|
||
qCol = textCol
|
||
else:
|
||
qCol = QColor(*textCol)
|
||
|
||
lblCol = self.palette()
|
||
lblCol.setColor(QPalette.WindowText, qCol)
|
||
self.setPalette(lblCol)
|
||
|
||
lblFont = self.font()
|
||
lblFont.setPointSizeF(fontSize*lblFont.pointSizeF())
|
||
self.setFont(lblFont)
|
||
|
||
return
|
||
|
||
# END Class QHelpLabel
|
||
|
||
# =============================================================================================== #
|
||
# Switch Widget
|
||
# =============================================================================================== #
|
||
|
||
class QSwitch(QAbstractButton):
|
||
|
||
def __init__(self, parent=None, width=40, height=20):
|
||
super().__init__(parent=parent)
|
||
|
||
self._xW = int(nw.CONFIG.guiScale*width)
|
||
self._xH = int(nw.CONFIG.guiScale*height)
|
||
self._xR = int(self._xH*0.5)
|
||
self._xT = int(self._xH*0.6)
|
||
self._rB = int(nw.CONFIG.guiScale*2)
|
||
self._rH = self._xH - 2*self._rB
|
||
self._rR = self._xR - self._rB
|
||
|
||
self.setCheckable(True)
|
||
self.setSizePolicy(QSizePolicy.Fixed, QSizePolicy.Fixed)
|
||
self.setFixedWidth(self._xW)
|
||
self.setFixedHeight(self._xH)
|
||
self._offset = self._xR
|
||
|
||
return
|
||
|
||
##
|
||
# Properties
|
||
##
|
||
|
||
@pyqtProperty(int)
|
||
def offset(self):
|
||
return self._offset
|
||
|
||
@offset.setter
|
||
def offset(self, theOffset):
|
||
self._offset = theOffset
|
||
self.update()
|
||
return
|
||
|
||
##
|
||
# Getters and Setters
|
||
##
|
||
|
||
def setChecked(self, isChecked):
|
||
"""Overload setChecked to also alter the offset.
|
||
"""
|
||
super().setChecked(isChecked)
|
||
if isChecked:
|
||
self.offset = self._xW - self._xR
|
||
else:
|
||
self.offset = self._xR
|
||
return
|
||
|
||
##
|
||
# Events
|
||
##
|
||
|
||
def resizeEvent(self, theEvent):
|
||
"""Overload resize to ensure correct offset.
|
||
"""
|
||
super().resizeEvent(theEvent)
|
||
if self.isChecked():
|
||
self.offset = self._xW - self._xR
|
||
else:
|
||
self.offset = self._xR
|
||
return
|
||
|
||
def paintEvent(self, event):
|
||
"""Drawing the switch itself.
|
||
"""
|
||
qPaint = QPainter(self)
|
||
qPaint.setRenderHint(QPainter.Antialiasing, True)
|
||
qPaint.setPen(Qt.NoPen)
|
||
|
||
qPalette = self.palette()
|
||
if self.isChecked():
|
||
trackBrush = qPalette.highlight()
|
||
thumbBrush = qPalette.highlightedText()
|
||
textColor = qPalette.highlight().color()
|
||
thumbText = nwUnicode.U_CHECK
|
||
else:
|
||
trackBrush = qPalette.dark()
|
||
thumbBrush = qPalette.light()
|
||
textColor = qPalette.dark().color()
|
||
thumbText = nwUnicode.U_MULT
|
||
|
||
if self.isEnabled():
|
||
trackOpacity = 1.0
|
||
else:
|
||
trackOpacity = 0.6
|
||
trackBrush = qPalette.shadow()
|
||
thumbBrush = qPalette.mid()
|
||
textColor = qPalette.shadow().color()
|
||
|
||
qPaint.setBrush(trackBrush)
|
||
qPaint.setOpacity(trackOpacity)
|
||
qPaint.drawRoundedRect(0, 0, self._xW, self._xH, self._xR, self._xR)
|
||
|
||
qPaint.setBrush(thumbBrush)
|
||
qPaint.drawEllipse(self.offset - self._rR, self._rB, self._rH, self._rH)
|
||
|
||
theFont = qPaint.font()
|
||
theFont.setPixelSize(self._xT)
|
||
qPaint.setPen(textColor)
|
||
qPaint.setFont(theFont)
|
||
qPaint.drawText(
|
||
QRectF(self.offset - self._rR, self._rB, self._rH, self._rH),
|
||
Qt.AlignCenter, thumbText
|
||
)
|
||
|
||
return
|
||
|
||
def mouseReleaseEvent(self, event):
|
||
"""Animate the switch on mouse release.
|
||
"""
|
||
super().mouseReleaseEvent(event)
|
||
if event.button() == Qt.LeftButton:
|
||
doAnim = QPropertyAnimation(self, b'offset', self)
|
||
doAnim.setDuration(120)
|
||
doAnim.setStartValue(self.offset)
|
||
if self.isChecked():
|
||
doAnim.setEndValue(self._xW - self._xR)
|
||
else:
|
||
doAnim.setEndValue(self._xR)
|
||
doAnim.start()
|
||
return
|
||
|
||
def enterEvent(self, event):
|
||
"""Change the cursor when hovering the button.
|
||
"""
|
||
self.setCursor(Qt.PointingHandCursor)
|
||
super().enterEvent(event)
|
||
return
|
||
|
||
# END Class QSwitch
|
||
|
||
# =============================================================================================== #
|
||
# Paged Dialog w/Custom TabWidget
|
||
# =============================================================================================== #
|
||
|
||
class PagedDialog(QDialog):
|
||
|
||
def __init__(self, theParent=None):
|
||
QDialog.__init__(self, parent=theParent)
|
||
|
||
self._outerBox = QVBoxLayout()
|
||
self._buttonBox = QHBoxLayout()
|
||
self._tabBox = QTabWidget()
|
||
|
||
self._tabBar = VerticalTabBar(self)
|
||
self._tabBox.setTabBar(self._tabBar)
|
||
self._tabBox.setTabPosition(QTabWidget.West)
|
||
self._tabBar.setExpanding(False)
|
||
|
||
self._outerBox.addWidget(self._tabBox)
|
||
self._outerBox.addLayout(self._buttonBox)
|
||
self.setLayout(self._outerBox)
|
||
|
||
# Default Margins
|
||
qM = self._outerBox.contentsMargins()
|
||
mL = qM.left()
|
||
mR = qM.right()
|
||
mT = qM.top()
|
||
mB = qM.bottom()
|
||
|
||
self.setContentsMargins(0, 0, 0, 0)
|
||
self._outerBox.setContentsMargins(0, 0, 0, mB)
|
||
self._buttonBox.setContentsMargins(mL, 0, mR, 0)
|
||
self._outerBox.setSpacing(mT)
|
||
|
||
return
|
||
|
||
def addTab(self, tabWidget, tabLabel):
|
||
"""Forwards the adding of tabs to the QTabWidget.
|
||
"""
|
||
self._tabBox.addTab(tabWidget, tabLabel)
|
||
return
|
||
|
||
def addControls(self, buttonBar):
|
||
"""Adds a button bar to the dialog.
|
||
"""
|
||
self._buttonBox.addWidget(buttonBar)
|
||
return
|
||
|
||
# END Class PagedDialog
|
||
|
||
class VerticalTabBar(QTabBar):
|
||
|
||
def __init__(self, theParent=None):
|
||
QTabBar.__init__(self, parent=theParent)
|
||
return
|
||
|
||
def tabSizeHint(self, theIndex):
|
||
"""Returns a transposed size hint for the rotated bar.
|
||
"""
|
||
tSize = QTabBar.tabSizeHint(self, theIndex)
|
||
tSize.transpose()
|
||
return tSize
|
||
|
||
def paintEvent(self, theEvent):
|
||
"""Custom implementation of the label painter that rotates the
|
||
label 90 degrees.
|
||
"""
|
||
pObj = QStylePainter(self)
|
||
oObj = QStyleOptionTab()
|
||
|
||
for i in range(self.count()):
|
||
self.initStyleOption(oObj, i)
|
||
pObj.drawControl(QStyle.CE_TabBarTabShape, oObj)
|
||
pObj.save()
|
||
|
||
oSize = oObj.rect.size()
|
||
oSize.transpose()
|
||
oRect = QRect(QPoint(), oSize)
|
||
oRect.moveCenter(oObj.rect.center())
|
||
oObj.rect = oRect
|
||
|
||
oCenter = self.tabRect(i).center()
|
||
pObj.translate(oCenter)
|
||
pObj.rotate(90)
|
||
pObj.translate(-oCenter)
|
||
pObj.drawControl(QStyle.CE_TabBarTabLabel, oObj)
|
||
pObj.restore()
|
||
|
||
return
|
||
|
||
# END Class VerticalTabBar
|
||
|
||
# =============================================================================================== #
|
||
# Quotes Dialog
|
||
# =============================================================================================== #
|
||
|
||
class QuotesDialog(QDialog):
|
||
|
||
def __init__(self, theParent=None, currentQuote="\""):
|
||
QDialog.__init__(self, parent=theParent)
|
||
|
||
self.mainConf = nw.CONFIG
|
||
|
||
self.outerBox = QVBoxLayout()
|
||
self.innerBox = QHBoxLayout()
|
||
self.labelBox = QVBoxLayout()
|
||
|
||
self.selectedQuote = currentQuote
|
||
|
||
qMetrics = QFontMetrics(self.font())
|
||
pxW = 7*qMetrics.boundingRectChar("M").width()
|
||
pxH = 7*qMetrics.boundingRectChar("M").height()
|
||
pxH = 7*qMetrics.boundingRectChar("M").height()
|
||
|
||
lblFont = self.font()
|
||
lblFont.setPointSizeF(4*lblFont.pointSizeF())
|
||
|
||
# Preview Label
|
||
self.previewLabel = QLabel(currentQuote)
|
||
self.previewLabel.setFont(lblFont)
|
||
self.previewLabel.setFixedSize(QSize(pxW, pxH))
|
||
self.previewLabel.setAlignment(Qt.AlignCenter)
|
||
self.previewLabel.setFrameStyle(QFrame.Box | QFrame.Plain)
|
||
|
||
# Quote Symbols
|
||
self.listBox = QListWidget()
|
||
self.listBox.itemSelectionChanged.connect(self._selectedSymbol)
|
||
|
||
minSize = 100
|
||
for sKey, sLabel in nwQuotes.SYMBOLS.items():
|
||
theText = "[ %s ] %s" % (sKey, sLabel)
|
||
minSize = max(minSize, qMetrics.boundingRect(theText).width())
|
||
qtItem = QListWidgetItem(theText)
|
||
qtItem.setData(Qt.UserRole, sKey)
|
||
self.listBox.addItem(qtItem)
|
||
if sKey == currentQuote:
|
||
self.listBox.setCurrentItem(qtItem)
|
||
|
||
self.listBox.setMinimumWidth(minSize + self.mainConf.pxInt(40))
|
||
self.listBox.setMinimumHeight(self.mainConf.pxInt(150))
|
||
|
||
# Buttons
|
||
self.buttonBox = QDialogButtonBox(QDialogButtonBox.Ok | QDialogButtonBox.Cancel)
|
||
self.buttonBox.accepted.connect(self._doAccept)
|
||
self.buttonBox.rejected.connect(self._doReject)
|
||
|
||
# Assemble
|
||
self.labelBox.addWidget(self.previewLabel, 0, Qt.AlignTop)
|
||
self.labelBox.addStretch(1)
|
||
|
||
self.innerBox.addLayout(self.labelBox)
|
||
self.innerBox.addWidget(self.listBox)
|
||
|
||
self.outerBox.addLayout(self.innerBox)
|
||
self.outerBox.addWidget(self.buttonBox)
|
||
|
||
self.setLayout(self.outerBox)
|
||
|
||
return
|
||
|
||
##
|
||
# Slots
|
||
##
|
||
|
||
def _selectedSymbol(self):
|
||
"""Update the preview label and the selected quote style.
|
||
"""
|
||
selItems = self.listBox.selectedItems()
|
||
if selItems:
|
||
theSymbol = selItems[0].data(Qt.UserRole)
|
||
self.previewLabel.setText(theSymbol)
|
||
self.selectedQuote = theSymbol
|
||
return
|
||
|
||
def _doAccept(self):
|
||
"""Ok button clicked.
|
||
"""
|
||
self.accept()
|
||
return
|
||
|
||
def _doReject(self):
|
||
"""Cancel button clicked.
|
||
"""
|
||
self.reject()
|
||
return
|
||
|
||
# END Class QuotesDialog
|