|
1 # -*- coding: utf-8 -*- |
|
2 |
|
3 # Copyright (c) 2006 - 2019 Detlev Offenbach <detlev@die-offenbachs.de> |
|
4 # |
|
5 |
|
6 """ |
|
7 Module implementing the Help Viewers configuration page. |
|
8 """ |
|
9 |
|
10 from __future__ import unicode_literals |
|
11 |
|
12 from PyQt5.QtWidgets import QButtonGroup |
|
13 try: |
|
14 from PyQt5 import QtWebKit # __IGNORE_WARNING__ |
|
15 WEBKIT_AVAILABLE = True |
|
16 except ImportError: |
|
17 WEBKIT_AVAILABLE = False |
|
18 |
|
19 from Globals import getWebBrowserSupport |
|
20 |
|
21 from E5Gui.E5PathPicker import E5PathPickerModes |
|
22 |
|
23 from .ConfigurationPageBase import ConfigurationPageBase |
|
24 from .Ui_HelpViewersPage import Ui_HelpViewersPage |
|
25 |
|
26 import Preferences |
|
27 |
|
28 |
|
29 class HelpViewersPage(ConfigurationPageBase, Ui_HelpViewersPage): |
|
30 """ |
|
31 Class implementing the Help Viewers configuration page. |
|
32 """ |
|
33 def __init__(self): |
|
34 """ |
|
35 Constructor |
|
36 """ |
|
37 super(HelpViewersPage, self).__init__() |
|
38 self.setupUi(self) |
|
39 self.setObjectName("HelpViewersPage") |
|
40 |
|
41 self.customViewerPicker.setMode(E5PathPickerModes.OpenFileMode) |
|
42 |
|
43 self.helpViewerGroup = QButtonGroup() |
|
44 self.helpViewerGroup.addButton(self.helpBrowserButton) |
|
45 self.helpViewerGroup.addButton(self.qtAssistantButton) |
|
46 self.helpViewerGroup.addButton(self.webBrowserButton) |
|
47 self.helpViewerGroup.addButton(self.customViewerButton) |
|
48 |
|
49 # set initial values |
|
50 webBrowserVariant = getWebBrowserSupport() |
|
51 if webBrowserVariant == "QtWebEngine": |
|
52 hvId = Preferences.getWebBrowser("HelpViewerType") |
|
53 elif webBrowserVariant == "QtWebKit": |
|
54 hvId = Preferences.getHelp("HelpViewerType") |
|
55 else: |
|
56 hvId = 3 |
|
57 self.helpBrowserButton.setEnabled(False) |
|
58 |
|
59 if hvId == 1: |
|
60 self.helpBrowserButton.setChecked(True) |
|
61 elif hvId == 2: |
|
62 self.qtAssistantButton.setChecked(True) |
|
63 elif hvId == 3: |
|
64 self.webBrowserButton.setChecked(True) |
|
65 else: |
|
66 self.customViewerButton.setChecked(True) |
|
67 self.customViewerPicker.setText( |
|
68 Preferences.getHelp("CustomViewer")) |
|
69 |
|
70 def save(self): |
|
71 """ |
|
72 Public slot to save the Help Viewers configuration. |
|
73 """ |
|
74 if self.helpBrowserButton.isChecked(): |
|
75 hvId = 1 |
|
76 elif self.qtAssistantButton.isChecked(): |
|
77 hvId = 2 |
|
78 elif self.webBrowserButton.isChecked(): |
|
79 hvId = 3 |
|
80 elif self.customViewerButton.isChecked(): |
|
81 hvId = 4 |
|
82 Preferences.setHelp("HelpViewerType", hvId) |
|
83 Preferences.setWebBrowser("HelpViewerType", hvId) |
|
84 Preferences.setHelp( |
|
85 "CustomViewer", |
|
86 self.customViewerPicker.text()) |
|
87 |
|
88 |
|
89 def create(dlg): |
|
90 """ |
|
91 Module function to create the configuration page. |
|
92 |
|
93 @param dlg reference to the configuration dialog |
|
94 @return reference to the instantiated page (ConfigurationPageBase) |
|
95 """ |
|
96 page = HelpViewersPage() |
|
97 return page |