--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/QScintilla/MarkupProviders/HyperlinkMarkupDialog.py Sat Jan 07 19:35:40 2017 +0100 @@ -0,0 +1,87 @@ +# -*- coding: utf-8 -*- + +# Copyright (c) 2017 Detlev Offenbach <detlev@die-offenbachs.de> +# + +""" +Module implementing a dialog to enter data to insert a hyperlink. +""" + +from PyQt5.QtCore import pyqtSlot +from PyQt5.QtWidgets import QDialog, QDialogButtonBox + +from .Ui_HyperlinkMarkupDialog import Ui_HyperlinkMarkupDialog + + +class HyperlinkMarkupDialog(QDialog, Ui_HyperlinkMarkupDialog): + """ + Class implementing a dialog to enter data to insert a hyperlink. + """ + def __init__(self, textMayBeEmpty, targetMayBeEmpty, noTitle=False, + parent=None): + """ + Constructor + + @param textMayBeEmpty flag indicating, that the link text may + be empty + @type bool + @param targetMayBeEmpty flag indicating, that the link target may + be empty + @type bool + @param noTitle flag indicating, that no title is supported + @type bool + @param parent reference to the parent widget + @type QWidget + """ + super(HyperlinkMarkupDialog, self).__init__(parent) + self.setupUi(self) + + self.__allowEmptyText = textMayBeEmpty + self.__allowEmptyTarget = targetMayBeEmpty + + self.titelEdit.setEnabled(not noTitle) + + self.__updateOkButton() + + def __updateOkButton(self): + """ + Private method to update the state of the OK button. + """ + self.buttonBox.button(QDialogButtonBox.Ok).setEnabled( + (bool(self.textEdit.text()) or self.__allowEmptyText) and + (bool(self.targetEdit.text()) or self.__allowEmptyTarget) + ) + + @pyqtSlot(str) + def on_textEdit_textChanged(self, txt): + """ + Private slot handling a change of the link text. + + @param txt link text + @type str + """ + self.__updateOkButton() + + @pyqtSlot(str) + def on_targetEdit_textChanged(self, tyt): + """ + Private slot handling a change of the link target. + + @param txt link target + @type str + """ + self.__updateOkButton() + + def getData(self): + """ + Public method to get the entered data. + + @return tuple containing the link text, link target and the optional + link title + @rtype tuple of (str, str, str) + """ + return ( + self.textEdit.text(), + self.targetEdit.text(), + self.titelEdit.text() + )