eric: Helpviewer/HelpBrowserWV.py@c9982bcd00f8 (annotated)

e6e21910210d Added capability to zoom by a pinch gesture to the editor, the shell, the terminal, the web browser and various graphics related windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1509

diff changeset

797

b3e34806b734 Extended the web page context menu by several entries to send links or the selected text, handling the clicked frame, translate the selected text with Google Translate and search it in Wictionary.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1584

diff changeset

799

1953

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

801

self.mw.greaseMonkeyManager().connectPage(self.page())

4341

1ff0929aab09 Added our own web inspector window to overcome a Qt weekness.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4326

diff changeset

803

self.__inspector = None

1518

e6e21910210d Added capability to zoom by a pinch gesture to the editor, the shell, the terminal, the web browser and various graphics related windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1509

diff changeset

805

self.grabGesture(Qt.PinchGesture)

945

8cd4d08fa9f6 Made code mostly PEP 8 compliant (except all whitespace and line length).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 923

diff changeset

807

def __addExternalBinding(self, frame=None):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

809

Private slot to add javascript bindings for adding search providers.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

811

@param frame reference to the web frame (QWebFrame)

2999

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

813

self.page().settings().setAttribute(QWebSettings.JavascriptEnabled,

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

815

if self.__javaScriptBinding is None:

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

817

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

819

# called from QWebFrame.javaScriptWindowObjectCleared

1584

38c0907eeea1 A little fix for the help browser.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1561

diff changeset

821

if isinstance(frame, HelpWebPage):

1665

b248526d3a1b Reworked some stuff in the web browser to use Qt resources.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1651

diff changeset

823

if frame.url().scheme() == "eric" and frame.url().path() == "home":

2999

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

825

self.__javaScriptEricObject = JavaScriptEricObject(

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

827

frame.addToJavaScriptWindowObject(

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

829

elif frame.url().scheme() == "eric" and \

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

831

frame.addToJavaScriptWindowObject(

1670

6fd889391d2c Added a Speed Dial to the web browser including the capability to select the first ten pages by pressing Meta+1 to Meta+0.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1665

diff changeset

833

self.__speedDial.addWebFrame(frame)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

835

# called from QWebPage.frameCreated

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

837

self.__addExternalBinding)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

839

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

841

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

843

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

845

@return list of linked resources (list of LinkedResource)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

847

resources = []

1947

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

849

baseUrl = self.page().mainFrame().baseUrl()

2999

28c75409a78f Continued to shorten the code lines to max. 79 characters.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2954

diff changeset

851

linkElements = self.page().mainFrame().findAllElements(

1947

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

853

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

855

rel = linkElement.attribute("rel")

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

857

type_ = linkElement.attribute("type")

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

859

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

861

continue

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

863

continue

1947

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

865

resource = LinkedResource()

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

867

resource.type_ = type_

815d1f3116ff Changed code to make eric compatible to PyQt 5.5 (QByteArry issue).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4355

diff changeset

869

QUrl.fromEncoded(href.encode("utf-8")))

84626f18f2c3 Simplified the code a little bit by deleting the checks for the existance of QWebElement because Qt 4.7 is the minimum requirement.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1945

diff changeset

871

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

873

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

875

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

877

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

879

"""

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

881

self.reload()

1953

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

883

def setSource(self, name, requestData=None):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

885

Public method used to set the source to be displayed.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

887

@param name filename to be shown (QUrl)

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

889

QNetworkAccessManager.Operation, QByteArray)

1953

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

891

if (name is None or not name.isValid()) and requestData is None:

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

893

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

895

name = requestData[0].url()

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

897

if self.ctrlPressed:

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

899

self.mw.newTab(name)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

901

return

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

903

if not name.scheme():

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

905

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

907

name.scheme() == "file":

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

909

if name.scheme() and len(name.scheme()) == 1:

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

911

name = QUrl.fromLocalFile(name.toString())

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

913

if not QFileInfo(name.toLocalFile()).exists():

542e97d4ecb3 Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2999

diff changeset

915

self,

3190

a9a94491c4fd Changed the code to use QObject.tr() instead of QObject.trUtf8().

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3160

diff changeset

917

self.tr(

3035

36e9f388958b Fixed a bunch of indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3034

diff changeset

919

.format(name.toLocalFile()))

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

921

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

923

name.toLocalFile().endswith(".PDF") or \

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

925

name.toLocalFile().endswith(".CHM"):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

927

if not started:

542e97d4ecb3 Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2999

diff changeset

929

self,

3190

a9a94491c4fd Changed the code to use QObject.tr() instead of QObject.trUtf8().

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3160

diff changeset

931

self.tr(

57179e4cdadd Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3020

diff changeset

933

""" for file {0}.""")

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

935

return

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

937

started = QDesktopServices.openUrl(name)

3020

542e97d4ecb3 Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2999

diff changeset

939

E5MessageBox.critical(

3670

f0cb7579c0b4 Finished renaming eric5 for PyQt5 to eric6.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3656

diff changeset

941

self.tr("eric6 Web Browser"),

3022

57179e4cdadd Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3020

diff changeset

943

"""Could not start an application"""

57179e4cdadd Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3020

diff changeset

945

.format(name.toString()))

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

947

elif name.scheme() == "javascript":

1690f30db6f3 Reverted the "ComponentFormattingOptions" changes done for Qt5 because PyQt4 has changed.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2094

diff changeset

949

QUrl.FormattingOptions(QUrl.TolerantMode | QUrl.RemoveScheme)))

0

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

951

return

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

953

if name.toString().endswith(".pdf") or \

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

955

name.toString().endswith(".chm") or \

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

957

started = QDesktopServices.openUrl(name)

3020

542e97d4ecb3 Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2999

diff changeset

959

E5MessageBox.critical(

3670

f0cb7579c0b4 Finished renaming eric5 for PyQt5 to eric6.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3656

diff changeset

961

self.tr("eric6 Web Browser"),

3022

57179e4cdadd Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3020

diff changeset

963

"""Could not start a viewer"""

57179e4cdadd Fixed a bunch of visible indentation issues.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 3020

diff changeset

965

.format(name.path()))

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

967

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

969

self.load(*requestData)

26aa6fd94dc2 Added support for GreaseMonkey scripts.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 1952

diff changeset

971

self.load(name)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

973

def source(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

975

Public method to return the URL of the loaded page.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

977

@return URL loaded in the help browser (QUrl)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

979

return self.url()

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

981

def documentTitle(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

983

Public method to return the title of the loaded page.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

985

@return title (string)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

987

return self.title()

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

989

def backward(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

991

Public slot to move backwards in history.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

993

self.triggerPageAction(QWebPage.Back)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

995

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

997

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

999

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1001

self.__urlChanged(self.history().currentItem().url())

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1003

def home(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1005

Public slot to move to the first page loaded.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1007

homeUrl = QUrl(Preferences.getHelp("HomePage"))

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1009

self.__urlChanged(self.history().currentItem().url())

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1011

def reload(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1013

Public slot to reload the current page.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1015

self.triggerPageAction(QWebPage.Reload)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1017

def copy(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1019

Public slot to copy the selected text.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1021

self.triggerPageAction(QWebPage.Copy)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1023

def isForwardAvailable(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1025

Public method to determine, if a forward move in history is possible.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1027

@return flag indicating move forward is possible (boolean)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1029

return self.history().canGoForward()

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1031

def isBackwardAvailable(self):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1033

Public method to determine, if a backwards move in history is possible.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1035

@return flag indicating move backwards is possible (boolean)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1037

return self.history().canGoBack()

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1039

def __levelForZoom(self, zoom):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1041

Private method determining the zoom level index given a zoom factor.

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1043

@param zoom zoom factor (integer)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1045

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1047

index = self.__zoomLevels.index(zoom)

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1049

for index in range(len(self.__zoomLevels)):

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1051

break

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1053

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1055

"""

de9c2efb9d02 Started porting eric4 to Python3

Detlev Offenbach <detlev@die-offenbachs.de>

parents:

diff changeset

1057

"""

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1059

2334

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1061

"""

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1063

4612

c9982bcd00f8 Added capability to remember the zoom values for each site (incl. a dialog to manage these).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4357

diff changeset

1065

@keyparam saveValue flag indicating to save the zoom value with the

c9982bcd00f8 Added capability to remember the zoom values for each site (incl. a dialog to manage these).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4357

diff changeset

1067

@type bool

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1069

if value != self.zoomValue():

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1071

self.setZoomFactor(value / 100.0)

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

1073

self.setTextSizeMultiplier(value / 100.0)

c9982bcd00f8 Added capability to remember the zoom values for each site (incl. a dialog to manage these).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4357

diff changeset

1075

if saveValue:

c9982bcd00f8 Added capability to remember the zoom values for each site (incl. a dialog to manage these).

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 4357

diff changeset

1077

self.url(), value)

fc69ad77e18a Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>

parents: 2302

diff changeset

 # -*- coding: utf-8 -*-
 # Copyright (c) 2008 - 2015 Detlev Offenbach <detlev@die-offenbachs.de>
 #
 """
 Module implementing the helpbrowser using QWebView.
 """
 from __future__ import unicode_literals
 try:
     str = unicode
 except NameError:
     pass
 from PyQt5.QtCore import pyqtSlot, pyqtSignal, QObject, QT_TRANSLATE_NOOP, \
     QUrl, QBuffer, QIODevice, QFileInfo, Qt, QTimer, QEvent, \
     QRect, QFile, QPoint, QByteArray, qVersion
 from PyQt5.QtGui import QDesktopServices, QClipboard, QMouseEvent, QColor, \
     QPalette
 from PyQt5.QtWidgets import qApp, QStyle, QMenu, QApplication, QInputDialog, \
     QLineEdit, QLabel, QToolTip, QFrame, QDialog
 from PyQt5.QtPrintSupport import QPrinter, QPrintDialog
 from PyQt5.QtWebKit import QWebSettings
 from PyQt5.QtWebKitWidgets import QWebView, QWebPage
 try:
     from PyQt5.QtWebKit import QWebElement
 except ImportError:
     pass
 from PyQt5.QtNetwork import QNetworkReply, QNetworkRequest
 import sip
 from E5Gui import E5MessageBox, E5FileDialog
 import Helpviewer
 import Preferences
 import UI.PixmapCache
 import Globals
 try:
     from PyQt5.QtNetwork import QSslCertificate
     SSL_AVAILABLE = True
 except ImportError:
     SSL_AVAILABLE = False
 ###############################################################################
 class JavaScriptExternalObject(QObject):
     """
     Class implementing an external javascript object to add search providers.
     """
     def __init__(self, mw, parent=None):
         """
         Constructor
         @param mw reference to the main window 8HelpWindow)
         @param parent reference to the parent object (QObject)
         """
         super(JavaScriptExternalObject, self).__init__(parent)
         self.__mw = mw
     @pyqtSlot(str)
     def AddSearchProvider(self, url):
         """
         Public slot to add a search provider.
         @param url url of the XML file defining the search provider (string)
         """
         self.__mw.openSearchManager().addEngine(QUrl(url))
 class LinkedResource(object):
     """
     Class defining a data structure for linked resources.
     """
     def __init__(self):
         """
         Constructor
         """
         self.rel = ""
         self.type_ = ""
         self.href = ""
         self.title = ""
 ###############################################################################
 class JavaScriptEricObject(QObject):
     """
     Class implementing an external javascript object to search via the
     startpage.
     """
     # these must be in line with the strings used by the javascript part of
     # the start page
     translations = [
         QT_TRANSLATE_NOOP("JavaScriptEricObject",
                           "Welcome to eric6 Web Browser!"),
         QT_TRANSLATE_NOOP("JavaScriptEricObject", "eric6 Web Browser"),
         QT_TRANSLATE_NOOP("JavaScriptEricObject", "Search!"),
         QT_TRANSLATE_NOOP("JavaScriptEricObject", "About eric6"),
     ]
     def __init__(self, mw, parent=None):
         """
         Constructor
         @param mw reference to the main window 8HelpWindow)
         @param parent reference to the parent object (QObject)
         """
         super(JavaScriptEricObject, self).__init__(parent)
         self.__mw = mw
     @pyqtSlot(str, result=str)
     def translate(self, trans):
         """
         Public method to translate the given string.
         @param trans string to be translated (string)
         @return translation (string)
         """
         if trans == "QT_LAYOUT_DIRECTION":
             # special handling to detect layout direction
             if qApp.isLeftToRight():
                 return "LTR"
             else:
                 return "RTL"
         return self.tr(trans)
     @pyqtSlot(result=str)
     def providerString(self):
         """
         Public method to get a string for the search provider.
         @return string for the search provider (string)
         """
         return self.tr("Search results provided by {0}")\
             .format(self.__mw.openSearchManager().currentEngineName())
     @pyqtSlot(str, result=str)
     def searchUrl(self, searchStr):
         """
         Public method to get the search URL for the given search term.
         @param searchStr search term (string)
         @return search URL (string)
         """
         return bytes(
             self.__mw.openSearchManager().currentEngine()
             .searchUrl(searchStr).toEncoded()).decode()
 ###############################################################################
 class HelpWebPage(QWebPage):
     """
     Class implementing an enhanced web page.
     """
     _webPluginFactory = None
     def __init__(self, parent=None):
         """
         Constructor
         @param parent parent widget of this window (QWidget)
         """
         super(HelpWebPage, self).__init__(parent)
         self.setPluginFactory(self.webPluginFactory())
         self.__lastRequest = None
         self.__lastRequestType = QWebPage.NavigationTypeOther
         import Helpviewer.HelpWindow
         from .Network.NetworkAccessManagerProxy import \
             NetworkAccessManagerProxy
         self.__proxy = NetworkAccessManagerProxy(self)
         self.__proxy.setWebPage(self)
         self.__proxy.setPrimaryNetworkAccessManager(
             Helpviewer.HelpWindow.HelpWindow.networkAccessManager())
         self.setNetworkAccessManager(self.__proxy)
         self.__sslConfiguration = None
         self.__proxy.finished.connect(self.__managerFinished)
         self.__adBlockedEntries = []
         self.loadStarted.connect(self.__loadStarted)
         self.saveFrameStateRequested.connect(
             self.__saveFrameStateRequested)
         self.restoreFrameStateRequested.connect(
             self.__restoreFrameStateRequested)
     def acceptNavigationRequest(self, frame, request, type_):
         """
         Public method to determine, if a request may be accepted.
         @param frame reference to the frame sending the request (QWebFrame)
         @param request reference to the request object (QNetworkRequest)
         @param type_ type of the navigation request (QWebPage.NavigationType)
         @return flag indicating acceptance (boolean)
         """
         self.__lastRequest = request
         if self.__lastRequest.url() != request.url() or \
            type_ != QWebPage.NavigationTypeOther:
             self.__lastRequestType = type_
         scheme = request.url().scheme()
         if scheme == "mailto":
             QDesktopServices.openUrl(request.url())
             return False
         if type_ == QWebPage.NavigationTypeFormResubmitted:
             res = E5MessageBox.yesNo(
                 self.view(),
                 self.tr("Resending POST request"),
                 self.tr(
                     """In order to display the site, the request along with"""
                     """ all the data must be sent once again, which may lead"""
                     """ to some unexpected behaviour of the site e.g. the"""
                     """ same action might be performed once again. Do you"""
                     """ want to continue anyway?"""),
                 icon=E5MessageBox.Warning)
             if not res:
                 return False
         return QWebPage.acceptNavigationRequest(self, frame, request, type_)
     def populateNetworkRequest(self, request):
         """
         Public method to add data to a network request.
         @param request reference to the network request object
             (QNetworkRequest)
         """
         try:
             request.setAttribute(QNetworkRequest.User + 100, self)
             if self.__lastRequest.url() == request.url():
                 request.setAttribute(QNetworkRequest.User + 101,
                                      self.__lastRequestType)
                 if self.__lastRequestType == \
                         QWebPage.NavigationTypeLinkClicked:
                     request.setRawHeader(b"X-Eric6-UserLoadAction",
                                          QByteArray(b"1"))
         except TypeError:
             pass
     def pageAttributeId(self):
         """
         Public method to get the attribute id of the page attribute.
         @return attribute id of the page attribute (integer)
         """
         return QNetworkRequest.User + 100
     def supportsExtension(self, extension):
         """
         Public method to check the support for an extension.
         @param extension extension to test for (QWebPage.Extension)
         @return flag indicating the support of extension (boolean)
         """
         try:
             if extension in [QWebPage.ErrorPageExtension,
                              QWebPage.ChooseMultipleFilesExtension]:
                 return True
         except AttributeError:
             pass
         return QWebPage.supportsExtension(self, extension)
     def extension(self, extension, option, output):
         """
         Public method to implement a specific extension.
         @param extension extension to be executed (QWebPage.Extension)
         @param option provides input to the extension
             (QWebPage.ExtensionOption)
         @param output stores the output results (QWebPage.ExtensionReturn)
         @return flag indicating a successful call of the extension (boolean)
         """
         if extension == QWebPage.ChooseMultipleFilesExtension:
             info = sip.cast(option,
                             QWebPage.ChooseMultipleFilesExtensionOption)
             files = sip.cast(output,
                              QWebPage.ChooseMultipleFilesExtensionReturn)
             if info is None or files is None:
                 return super(HelpWebPage, self).extension(
                     extension, option, output)
             suggestedFileName = ""
             if info.suggestedFileNames:
                 suggestedFileName = info.suggestedFileNames[0]
             files.fileNames = E5FileDialog.getOpenFileNames(
                 None,
                 self.tr("Select files to upload..."),
                 suggestedFileName)
             return True
         if extension == QWebPage.ErrorPageExtension:
             info = sip.cast(option, QWebPage.ErrorPageExtensionOption)
             errorPage = sip.cast(output, QWebPage.ErrorPageExtensionReturn)
             urlString = bytes(info.url.toEncoded()).decode()
             errorPage.baseUrl = info.url
             if info.domain == QWebPage.QtNetwork and \
                info.error == QNetworkReply.ProtocolUnknownError:
                 url = QUrl(info.url)
                 res = E5MessageBox.yesNo(
                     None,
                     self.tr("Protocol Error"),
                     self.tr("""Open external application for {0}-link?\n"""
                             """URL: {1}""").format(
                         url.scheme(), url.toString(
                             QUrl.PrettyDecoded | QUrl.RemovePassword)),
                     yesDefault=True)
                 if res:
                     QDesktopServices.openUrl(url)
                 return True
             elif info.domain == QWebPage.QtNetwork and \
                 info.error == QNetworkReply.ContentAccessDenied and \
                     info.errorString.startswith("AdBlockRule:"):
                 if info.frame != info.frame.page().mainFrame():
                     # content in <iframe>
                     docElement = info.frame.page().mainFrame()\
                         .documentElement()
                     for element in docElement.findAll("iframe"):
                         src = element.attribute("src")
                         if src in info.url.toString():
                             element.setAttribute("style", "display:none;")
                     return False
                 else:
                     # the whole page is blocked
                     rule = info.errorString.replace("AdBlockRule:", "")
                     title = self.tr("Content blocked by AdBlock Plus")
                     message = self.tr(
                         "Blocked by rule: <i>{0}</i>").format(rule)
                     htmlFile = QFile(":/html/adblockPage.html")
                     htmlFile.open(QFile.ReadOnly)
                     html = htmlFile.readAll()
                     html = html.replace(
                         "@FAVICON@", "qrc:icons/adBlockPlus16.png")
                     html = html.replace(
                         "@IMAGE@", "qrc:icons/adBlockPlus64.png")
                     html = html.replace("@TITLE@", title.encode("utf8"))
                     html = html.replace("@MESSAGE@", message.encode("utf8"))
                     errorPage.content = html
                     return True
             if info.domain == QWebPage.QtNetwork and \
                info.error == QNetworkReply.OperationCanceledError and \
                info.errorString == "eric6:No Error":
                 return False
             if info.domain == QWebPage.WebKit and info.error == 203:
                 # "Loading is handled by the media engine"
                 return False
             title = self.tr("Error loading page: {0}").format(urlString)
             htmlFile = QFile(":/html/notFoundPage.html")
             htmlFile.open(QFile.ReadOnly)
             html = htmlFile.readAll()
             pixmap = qApp.style()\
                 .standardIcon(QStyle.SP_MessageBoxWarning).pixmap(48, 48)
             imageBuffer = QBuffer()
             imageBuffer.open(QIODevice.ReadWrite)
             if pixmap.save(imageBuffer, "PNG"):
                 html = html.replace("@IMAGE@", imageBuffer.buffer().toBase64())
             pixmap = qApp.style()\
                 .standardIcon(QStyle.SP_MessageBoxWarning).pixmap(16, 16)
             imageBuffer = QBuffer()
             imageBuffer.open(QIODevice.ReadWrite)
             if pixmap.save(imageBuffer, "PNG"):
                 html = html.replace(
                     "@FAVICON@", imageBuffer.buffer().toBase64())
             html = html.replace("@TITLE@", title.encode("utf8"))
             html = html.replace("@H1@", info.errorString.encode("utf8"))
             html = html.replace(
                 "@H2@", self.tr("When connecting to: {0}.")
                 .format(urlString).encode("utf8"))
             html = html.replace(
                 "@LI-1@",
                 self.tr("Check the address for errors such as "
                         "<b>ww</b>.example.org instead of "
                         "<b>www</b>.example.org").encode("utf8"))
             html = html.replace(
                 "@LI-2@",
                 self.tr(
                     "If the address is correct, try checking the network "
                     "connection.").encode("utf8"))
             html = html.replace(
                 "@LI-3@",
                 self.tr(
                     "If your computer or network is protected by a firewall "
                     "or proxy, make sure that the browser is permitted to "
                     "access the network.").encode("utf8"))
             html = html.replace(
                 "@LI-4@",
                 self.tr("If your cache policy is set to offline browsing,"
                         "only pages in the local cache are available.")
                 .encode("utf8"))
             html = html.replace(
                 "@BUTTON@", self.tr("Try Again").encode("utf8"))
             errorPage.content = html
             return True
         return QWebPage.extension(self, extension, option, output)
     def __loadStarted(self):
         """
         Private method to handle the loadStarted signal.
         """
         self.__adBlockedEntries = []
     def addAdBlockRule(self, rule, url):
         """
         Public slot to add an AdBlock rule to the page.
         @param rule AdBlock rule to add (AdBlockRule)
         @param url URL that matched the rule (QUrl)
         """
         from .AdBlock.AdBlockPage import AdBlockedPageEntry
         entry = AdBlockedPageEntry(rule, url)
         if entry not in self.__adBlockedEntries:
             self.__adBlockedEntries.append(entry)
     def getAdBlockedPageEntries(self):
         """
         Public method to get the list of AdBlock page entries.
         @return list of AdBlock page entries (list of AdBlockedPageEntry)
         """
         return self.__adBlockedEntries
     def url(self):
         """
         Public method to get the URL of the page.
         @return URL of the page (QUrl)
         """
         return self.mainFrame().url()
     def userAgent(self, resolveEmpty=False):
         """
         Public method to get the global user agent setting.
         @param resolveEmpty flag indicating to resolve an empty
             user agent (boolean)
         @return user agent string (string)
         """
         agent = Preferences.getHelp("UserAgent")
         if agent == "" and resolveEmpty:
             agent = self.userAgentForUrl(QUrl())
         return agent
     def setUserAgent(self, agent):
         """
         Public method to set the global user agent string.
         @param agent new current user agent string (string)
         """
         Preferences.setHelp("UserAgent", agent)
     def userAgentForUrl(self, url):
         """
         Public method to determine the user agent for the given URL.
         @param url URL to determine user agent for (QUrl)
         @return user agent string (string)
         """
         import Helpviewer.HelpWindow
         agent = Helpviewer.HelpWindow.HelpWindow.userAgentsManager()\
             .userAgentForUrl(url)
         if agent == "":
             # no agent string specified for the given host -> use global one
             agent = Preferences.getHelp("UserAgent")
             if agent == "":
                 # no global agent string specified -> use default one
                 agent = QWebPage.userAgentForUrl(self, url)
         return agent
     def __managerFinished(self, reply):
         """
         Private slot to handle a finished reply.
         This slot is used to get SSL related information for a reply.
         @param reply reference to the finished reply (QNetworkReply)
         """
         try:
             frame = reply.request().originatingObject()
         except AttributeError:
             frame = None
         mainFrameRequest = frame == self.mainFrame()
         if mainFrameRequest and \
            self.__sslConfiguration is not None and \
            reply.url() == self.mainFrame().url():
             self.__sslConfiguration = None
         if reply.error() == QNetworkReply.NoError and \
            mainFrameRequest and \
            self.__sslConfiguration is None and \
            reply.url().scheme().lower() == "https" and \
            reply.url() == self.mainFrame().url():
             self.__sslConfiguration = reply.sslConfiguration()
             self.__sslConfiguration.url = QUrl(reply.url())
         if reply.error() == QNetworkReply.NoError and \
            mainFrameRequest and \
            reply.url() == self.mainFrame().url():
             modified = reply.header(QNetworkRequest.LastModifiedHeader)
             if modified and modified.isValid():
                 import Helpviewer.HelpWindow
                 manager = Helpviewer.HelpWindow.HelpWindow.bookmarksManager()
                 from .Bookmarks.BookmarkNode import BookmarkNode
                 for bookmark in manager.bookmarksForUrl(reply.url()):
                     manager.setTimestamp(bookmark, BookmarkNode.TsModified,
                                          modified)
     def getSslCertificate(self):
         """
         Public method to get a reference to the SSL certificate.
         @return amended SSL certificate (QSslCertificate)
         """
         if self.__sslConfiguration is None:
             return None
         sslInfo = self.__sslConfiguration.peerCertificate()
         sslInfo.url = QUrl(self.__sslConfiguration.url)
         return sslInfo
     def getSslCertificateChain(self):
         """
         Public method to get a reference to the SSL certificate chain.
         @return SSL certificate chain (list of QSslCertificate)
         """
         if self.__sslConfiguration is None:
             return []
         chain = self.__sslConfiguration.peerCertificateChain()
         return chain
     def getSslConfiguration(self):
         """
         Public method to return a reference to the current SSL configuration.
         @return reference to the SSL configuration in use (QSslConfiguration)
         """
         return self.__sslConfiguration
     def showSslInfo(self, pos):
         """
         Public slot to show some SSL information for the loaded page.
         @param pos position to show the info at (QPoint)
         """
         if SSL_AVAILABLE and self.__sslConfiguration is not None:
             from E5Network.E5SslInfoWidget import E5SslInfoWidget
             widget = E5SslInfoWidget(
                 self.mainFrame().url(), self.__sslConfiguration, self.view())
             widget.showAt(pos)
         else:
             E5MessageBox.warning(
                 self.view(),
                 self.tr("SSL Info"),
                 self.tr("""This site does not contain SSL information."""))
     def hasValidSslInfo(self):
         """
         Public method to check, if the page has a valid SSL certificate.
         @return flag indicating a valid SSL certificate (boolean)
         """
         if self.__sslConfiguration is None:
             return False
         certList = self.__sslConfiguration.peerCertificateChain()
         if not certList:
             return False
         certificateDict = Globals.toDict(
             Preferences.Prefs.settings.value("Ssl/CaCertificatesDict"))
         for server in certificateDict:
             localCAList = QSslCertificate.fromData(certificateDict[server])
             for cert in certList:
                 if cert in localCAList:
                     return True
         if qVersion() >= "5.0.0":
             for cert in certList:
                 if cert.isBlacklisted():
                     return False
         else:
             for cert in certList:
                 if not cert.isValid():
                     return False
         return True
     @classmethod
     def webPluginFactory(cls):
         """
         Class method to get a reference to the web plug-in factory
         instance.
         @return reference to the web plug-in factory instance (WebPluginFactory
         """
         if cls._webPluginFactory is None:
             from .WebPlugins.WebPluginFactory import WebPluginFactory
             cls._webPluginFactory = WebPluginFactory()
         return cls._webPluginFactory
     def event(self, evt):
         """
         Public method implementing the event handler.
         @param evt reference to the event (QEvent)
         @return flag indicating that the event was handled (boolean)
         """
         if evt.type() == QEvent.Leave:
             # Fake a mouse move event just outside of the widget to trigger
             # the WebKit event handler's mouseMoved function. This implements
             # the interesting mouse-out behavior like invalidating scrollbars.
             fakeEvent = QMouseEvent(QEvent.MouseMove, QPoint(0, -1),
                                     Qt.NoButton, Qt.NoButton, Qt.NoModifier)
             return super(HelpWebPage, self).event(fakeEvent)
         return super(HelpWebPage, self).event(evt)
     def __saveFrameStateRequested(self, frame, itm):
         """
         Private slot to save the page state (i.e. zoom level and scroll
         position).
         Note: Code is based on qutebrowser.
         @param frame frame to be saved
         @type QWebFrame
         @param itm web history item to be saved
         @type QWebHistoryItem
         """
         try:
             if frame != self.mainFrame():
                 return
         except RuntimeError:
             # With Qt 5.2.1 (Ubuntu Trusty) we get this when closing a tab:
             #     RuntimeError: wrapped C/C++ object of type BrowserPage has
             #     been deleted
             # Since the information here isn't that important for closing web
             # views anyways, we ignore this error.
             return
         data = {
             'zoom': frame.zoomFactor(),
             'scrollPos': frame.scrollPosition(),
         }
         itm.setUserData(data)
     def __restoreFrameStateRequested(self, frame):
         """
         Private slot to restore scroll position and zoom level from
         history.
         Note: Code is based on qutebrowser.
         @param frame frame to be restored
         @type QWebFrame
         """
         if frame != self.mainFrame():
             return
         data = self.history().currentItem().userData()
         if data is None:
             return
         if 'zoom' in data:
             frame.page().view().setZoomValue(int(data['zoom'] * 100),
                                              saveValue=False)
         if 'scrollPos' in data and frame.scrollPosition() == QPoint(0, 0):
             frame.setScrollPosition(data['scrollPos'])
 ###############################################################################
 class HelpBrowser(QWebView):
     """
     Class implementing the helpbrowser widget.
     This is a subclass of the Qt QWebView to implement an
     interface compatible with the QTextBrowser based variant.
     @signal sourceChanged(QUrl) emitted after the current URL has changed
     @signal forwardAvailable(bool) emitted after the current URL has changed
     @signal backwardAvailable(bool) emitted after the current URL has changed
     @signal highlighted(str) emitted, when the mouse hovers over a link
     @signal search(QUrl) emitted, when a search is requested
     @signal zoomValueChanged(int) emitted to signal a change of the zoom value
     """
     sourceChanged = pyqtSignal(QUrl)
     forwardAvailable = pyqtSignal(bool)
     backwardAvailable = pyqtSignal(bool)
     highlighted = pyqtSignal(str)
     search = pyqtSignal(QUrl)
     zoomValueChanged = pyqtSignal(int)
     ZoomLevels = [
 , 50, 67, 80, 90,
 ,
 , 120, 133, 150, 170, 200, 240, 300,
     ]
     ZoomLevelDefault = 100
     def __init__(self, mainWindow, parent=None, name=""):
         """
         Constructor
         @param mainWindow reference to the main window (HelpWindow)
         @param parent parent widget of this window (QWidget)
         @param name name of this window (string)
         """
         super(HelpBrowser, self).__init__(parent)
         self.setObjectName(name)
         self.setWhatsThis(self.tr(
             """<b>Help Window</b>"""
             """<p>This window displays the selected help information.</p>"""
         ))
         import Helpviewer.HelpWindow
         self.__speedDial = Helpviewer.HelpWindow.HelpWindow.speedDial()
         self.__page = HelpWebPage(self)
         self.setPage(self.__page)
         self.mw = mainWindow
         self.ctrlPressed = False
         self.__isLoading = False
         self.__progress = 0
         self.__currentZoom = 100
         self.__zoomLevels = HelpBrowser.ZoomLevels[:]
         self.__javaScriptBinding = None
         self.__javaScriptEricObject = None
         self.mw.zoomTextOnlyChanged.connect(self.__applyZoom)
         self.page().setLinkDelegationPolicy(QWebPage.DelegateAllLinks)
         self.linkClicked.connect(self.setSource)
         self.urlChanged.connect(self.__urlChanged)
         self.statusBarMessage.connect(self.__statusBarMessage)
         self.page().linkHovered.connect(self.__linkHovered)
         self.loadStarted.connect(self.__loadStarted)
         self.loadProgress.connect(self.__loadProgress)
         self.loadFinished.connect(self.__loadFinished)
         self.page().setForwardUnsupportedContent(True)
         self.page().unsupportedContent.connect(self.__unsupportedContent)
         self.page().featurePermissionRequested.connect(
             self.__featurePermissionRequested)
         self.page().downloadRequested.connect(self.__downloadRequested)
         self.page().frameCreated.connect(self.__addExternalBinding)
         self.__addExternalBinding(self.page().mainFrame())
         self.page().databaseQuotaExceeded.connect(self.__databaseQuotaExceeded)
         self.mw.openSearchManager().currentEngineChanged.connect(
             self.__currentEngineChanged)
         self.setAcceptDrops(True)
         self.__enableAccessKeys = Preferences.getHelp("AccessKeysEnabled")
         self.__accessKeysPressed = False
         self.__accessKeyLabels = []
         self.__accessKeyNodes = {}
         self.page().loadStarted.connect(self.__hideAccessKeys)
         self.page().scrollRequested.connect(self.__hideAccessKeys)
         self.__rss = []
         self.__clickedFrame = None
         self.mw.personalInformationManager().connectPage(self.page())
         self.mw.greaseMonkeyManager().connectPage(self.page())
         self.__inspector = None
         self.grabGesture(Qt.PinchGesture)
     def __addExternalBinding(self, frame=None):
         """
         Private slot to add javascript bindings for adding search providers.
         @param frame reference to the web frame (QWebFrame)
         """
         self.page().settings().setAttribute(QWebSettings.JavascriptEnabled,
                                             True)
         if self.__javaScriptBinding is None:
             self.__javaScriptBinding = JavaScriptExternalObject(self.mw, self)
         if frame is None:
             # called from QWebFrame.javaScriptWindowObjectCleared
             frame = self.sender()
             if isinstance(frame, HelpWebPage):
                 frame = frame.mainFrame()
             if frame.url().scheme() == "eric" and frame.url().path() == "home":
                 if self.__javaScriptEricObject is None:
                     self.__javaScriptEricObject = JavaScriptEricObject(
                         self.mw, self)
                 frame.addToJavaScriptWindowObject(
                     "eric", self.__javaScriptEricObject)
             elif frame.url().scheme() == "eric" and \
                     frame.url().path() == "speeddial":
                 frame.addToJavaScriptWindowObject(
                     "speeddial", self.__speedDial)
                 self.__speedDial.addWebFrame(frame)
         else:
             # called from QWebPage.frameCreated
             frame.javaScriptWindowObjectCleared.connect(
                 self.__addExternalBinding)
         frame.addToJavaScriptWindowObject("external", self.__javaScriptBinding)
     def linkedResources(self, relation=""):
         """
         Public method to extract linked resources.
         @param relation relation to extract (string)
         @return list of linked resources (list of LinkedResource)
         """
         resources = []
         baseUrl = self.page().mainFrame().baseUrl()
         linkElements = self.page().mainFrame().findAllElements(
             "html > head > link")
         for linkElement in linkElements.toList():
             rel = linkElement.attribute("rel")
             href = linkElement.attribute("href")
             type_ = linkElement.attribute("type")
             title = linkElement.attribute("title")
             if href == "" or type_ == "":
                 continue
             if relation and rel != relation:
                 continue
             resource = LinkedResource()
             resource.rel = rel
             resource.type_ = type_
             resource.href = baseUrl.resolved(
                 QUrl.fromEncoded(href.encode("utf-8")))
             resource.title = title
             resources.append(resource)
         return resources
     def __currentEngineChanged(self):
         """
         Private slot to track a change of the current search engine.
         """
         if self.url().toString() == "eric:home":
             self.reload()
     def setSource(self, name, requestData=None):
         """
         Public method used to set the source to be displayed.
         @param name filename to be shown (QUrl)
         @param requestData tuple containing the request data (QNetworkRequest,
             QNetworkAccessManager.Operation, QByteArray)
         """
         if (name is None or not name.isValid()) and requestData is None:
             return
         if name is None and requestData is not None:
             name = requestData[0].url()
         if self.ctrlPressed:
             # open in a new window
             self.mw.newTab(name)
             self.ctrlPressed = False
             return
         if not name.scheme():
             name.setUrl(Preferences.getHelp("DefaultScheme") + name.toString())
         if len(name.scheme()) == 1 or \
            name.scheme() == "file":
             # name is a local file
             if name.scheme() and len(name.scheme()) == 1:
                 # it is a local path on win os
                 name = QUrl.fromLocalFile(name.toString())
             if not QFileInfo(name.toLocalFile()).exists():
                 E5MessageBox.critical(
                     self,
                     self.tr("eric6 Web Browser"),
                     self.tr(
                         """<p>The file <b>{0}</b> does not exist.</p>""")
                     .format(name.toLocalFile()))
                 return
             if name.toLocalFile().endswith(".pdf") or \
                name.toLocalFile().endswith(".PDF") or \
                name.toLocalFile().endswith(".chm") or \
                name.toLocalFile().endswith(".CHM"):
                 started = QDesktopServices.openUrl(name)
                 if not started:
                     E5MessageBox.critical(
                         self,
                         self.tr("eric6 Web Browser"),
                         self.tr(
                             """<p>Could not start a viewer"""
                             """ for file <b>{0}</b>.</p>""")
                         .format(name.path()))
                 return
         elif name.scheme() in ["mailto"]:
             started = QDesktopServices.openUrl(name)
             if not started:
                 E5MessageBox.critical(
                     self,
                     self.tr("eric6 Web Browser"),
                     self.tr(
                         """<p>Could not start an application"""
                         """ for URL <b>{0}</b>.</p>""")
                     .format(name.toString()))
             return
         elif name.scheme() == "javascript":
             scriptSource = QUrl.fromPercentEncoding(name.toString(
                 QUrl.FormattingOptions(QUrl.TolerantMode | QUrl.RemoveScheme)))
             self.page().mainFrame().evaluateJavaScript(scriptSource)
             return
         else:
             if name.toString().endswith(".pdf") or \
                name.toString().endswith(".PDF") or \
                name.toString().endswith(".chm") or \
                name.toString().endswith(".CHM"):
                 started = QDesktopServices.openUrl(name)
                 if not started:
                     E5MessageBox.critical(
                         self,
                         self.tr("eric6 Web Browser"),
                         self.tr(
                             """<p>Could not start a viewer"""
                             """ for file <b>{0}</b>.</p>""")
                         .format(name.path()))
                 return
         if requestData is not None:
             self.load(*requestData)
         else:
             self.load(name)
     def source(self):
         """
         Public method to return the URL of the loaded page.
         @return URL loaded in the help browser (QUrl)
         """
         return self.url()
     def documentTitle(self):
         """
         Public method to return the title of the loaded page.
         @return title (string)
         """
         return self.title()
     def backward(self):
         """
         Public slot to move backwards in history.
         """
         self.triggerPageAction(QWebPage.Back)
         self.__urlChanged(self.history().currentItem().url())
     def forward(self):
         """
         Public slot to move forward in history.
         """
         self.triggerPageAction(QWebPage.Forward)
         self.__urlChanged(self.history().currentItem().url())
     def home(self):
         """
         Public slot to move to the first page loaded.
         """
         homeUrl = QUrl(Preferences.getHelp("HomePage"))
         self.setSource(homeUrl)
         self.__urlChanged(self.history().currentItem().url())
     def reload(self):
         """
         Public slot to reload the current page.
         """
         self.triggerPageAction(QWebPage.Reload)
     def copy(self):
         """
         Public slot to copy the selected text.
         """
         self.triggerPageAction(QWebPage.Copy)
     def isForwardAvailable(self):
         """
         Public method to determine, if a forward move in history is possible.
         @return flag indicating move forward is possible (boolean)
         """
         return self.history().canGoForward()
     def isBackwardAvailable(self):
         """
         Public method to determine, if a backwards move in history is possible.
         @return flag indicating move backwards is possible (boolean)
         """
         return self.history().canGoBack()
     def __levelForZoom(self, zoom):
         """
         Private method determining the zoom level index given a zoom factor.
         @param zoom zoom factor (integer)
         @return index of zoom factor (integer)
         """
         try:
             index = self.__zoomLevels.index(zoom)
         except ValueError:
             for index in range(len(self.__zoomLevels)):
                 if zoom <= self.__zoomLevels[index]:
                     break
         return index
     def __applyZoom(self):
         """
         Private slot to apply the current zoom factor.
         """
         self.setZoomValue(self.__currentZoom)
     def setZoomValue(self, value, saveValue=True):
         """
         Public method to set the zoom value.
         @param value zoom value (integer)
         @keyparam saveValue flag indicating to save the zoom value with the
             zoom manager
         @type bool
         """
         if value != self.zoomValue():
             try:
                 self.setZoomFactor(value / 100.0)
             except AttributeError:
                 self.setTextSizeMultiplier(value / 100.0)
             self.__currentZoom = value
             if saveValue:
                 Helpviewer.HelpWindow.HelpWindow.zoomManager().setZoomValue(
                     self.url(), value)
             self.zoomValueChanged.emit(value)
 fc69ad77e18a
Introduced a zoom widget in the status bar of several windows.

Detlev Offenbach <detlev@die-offenbachs.de>
parents: 
2302
diff
changeset

Mercurial Repositories > eric / annotate

Helpviewer/HelpBrowserWV.py@c9982bcd00f8 (annotated)

Helpviewer/HelpBrowserWV.py