Sophie: qtwebengine5-doc-5.9.4-1.mga6 noarch

qtwebengine5-doc-5.9.4-1.mga6.noarch.rpm

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  <title>webview.cpp Example File | Qt WebEngine 5.9</title>
  <link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
  <script type="text/javascript">
    document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
    // loading style sheet breaks anchors that were jumped to before
    // so force jumping to anchor again
    setTimeout(function() {
        var anchor = location.hash;
        // need to jump to different anchor first (e.g. none)
        location.hash = "#";
        setTimeout(function() {
            location.hash = anchor;
        }, 0);
    }, 0);
  </script>
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="main">
    <div class="main-rounded">
      <div class="navigationbar">
        <table><tr>
<td >Qt 5.9</td><td ><a href="qtwebengine-index.html">Qt WebEngine</a></td><td ><a href="qtwebengine-webenginewidgets-simplebrowser-example.html">WebEngine Widgets Simple Browser Example</a></td><td >webview.cpp Example File</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right">Qt 5.9.4 Reference Documentation</td>
        </tr></table>
      </div>
    </div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar"><div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">webview.cpp Example File</h1>
<span class="subtitle">webenginewidgets/simplebrowser/webview.cpp</span>
<!-- $$$webenginewidgets/simplebrowser/webview.cpp-description -->
<div class="descr"> <a name="details"></a>
<pre class="cpp">

  <span class="comment">/****************************************************************************
  **
  ** Copyright (C) 2016 The Qt Company Ltd.
  ** Contact: https://www.qt.io/licensing/
  **
  ** This file is part of the examples of the Qt Toolkit.
  **
  ** $QT_BEGIN_LICENSE:BSD$
  ** Commercial License Usage
  ** Licensees holding valid commercial Qt licenses may use this file in
  ** accordance with the commercial license agreement provided with the
  ** Software or, alternatively, in accordance with the terms contained in
  ** a written agreement between you and The Qt Company. For licensing terms
  ** and conditions see https://www.qt.io/terms-conditions. For further
  ** information use the contact form at https://www.qt.io/contact-us.
  **
  ** BSD License Usage
  ** Alternatively, you may use this file under the terms of the BSD license
  ** as follows:
  **
  ** &quot;Redistribution and use in source and binary forms, with or without
  ** modification, are permitted provided that the following conditions are
  ** met:
  **   * Redistributions of source code must retain the above copyright
  **     notice, this list of conditions and the following disclaimer.
  **   * Redistributions in binary form must reproduce the above copyright
  **     notice, this list of conditions and the following disclaimer in
  **     the documentation and/or other materials provided with the
  **     distribution.
  **   * Neither the name of The Qt Company Ltd nor the names of its
  **     contributors may be used to endorse or promote products derived
  **     from this software without specific prior written permission.
  **
  **
  ** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  ** &quot;AS IS&quot; AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  ** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  ** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  ** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  ** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  ** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  ** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.&quot;
  **
  ** $QT_END_LICENSE$
  **
  ****************************************************************************/</span>

  <span class="preprocessor">#include &quot;browser.h&quot;</span>
  <span class="preprocessor">#include &quot;browserwindow.h&quot;</span>
  <span class="preprocessor">#include &quot;tabwidget.h&quot;</span>
  <span class="preprocessor">#include &quot;webpage.h&quot;</span>
  <span class="preprocessor">#include &quot;webpopupwindow.h&quot;</span>
  <span class="preprocessor">#include &quot;webview.h&quot;</span>
  <span class="preprocessor">#include &lt;QContextMenuEvent&gt;</span>
  <span class="preprocessor">#include &lt;QDebug&gt;</span>
  <span class="preprocessor">#include &lt;QMenu&gt;</span>
  <span class="preprocessor">#include &lt;QMessageBox&gt;</span>
  <span class="preprocessor">#include &lt;QTimer&gt;</span>

  WebView<span class="operator">::</span>WebView(<span class="type">QWidget</span> <span class="operator">*</span>parent)
      : <span class="type"><a href="qwebengineview.html">QWebEngineView</a></span>(parent)
      <span class="operator">,</span> m_loadProgress(<span class="number">100</span>)
  {
      connect(<span class="keyword">this</span><span class="operator">,</span> <span class="operator">&amp;</span><span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>loadStarted<span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span>() {
          m_loadProgress <span class="operator">=</span> <span class="number">0</span>;
          <span class="keyword">emit</span> favIconChanged(favIcon());
      });
      connect(<span class="keyword">this</span><span class="operator">,</span> <span class="operator">&amp;</span><span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>loadProgress<span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span>(<span class="type">int</span> progress) {
          m_loadProgress <span class="operator">=</span> progress;
      });
      connect(<span class="keyword">this</span><span class="operator">,</span> <span class="operator">&amp;</span><span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>loadFinished<span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span>(bool success) {
          m_loadProgress <span class="operator">=</span> success <span class="operator">?</span> <span class="number">100</span> : <span class="operator">-</span><span class="number">1</span>;
          <span class="keyword">emit</span> favIconChanged(favIcon());
      });
      connect(<span class="keyword">this</span><span class="operator">,</span> <span class="operator">&amp;</span><span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>iconChanged<span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span>(<span class="keyword">const</span> <span class="type">QIcon</span> <span class="operator">&amp;</span>) {
          <span class="keyword">emit</span> favIconChanged(favIcon());
      });

      connect(<span class="keyword">this</span><span class="operator">,</span> <span class="operator">&amp;</span><span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>renderProcessTerminated<span class="operator">,</span>
              <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span>(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>RenderProcessTerminationStatus termStatus<span class="operator">,</span> <span class="type">int</span> statusCode) {
          <span class="type">QString</span> status;
          <span class="keyword">switch</span> (termStatus) {
          <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>NormalTerminationStatus:
              status <span class="operator">=</span> tr(<span class="string">&quot;Render process normal exit&quot;</span>);
              <span class="keyword">break</span>;
          <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>AbnormalTerminationStatus:
              status <span class="operator">=</span> tr(<span class="string">&quot;Render process abnormal exit&quot;</span>);
              <span class="keyword">break</span>;
          <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>CrashedTerminationStatus:
              status <span class="operator">=</span> tr(<span class="string">&quot;Render process crashed&quot;</span>);
              <span class="keyword">break</span>;
          <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>KilledTerminationStatus:
              status <span class="operator">=</span> tr(<span class="string">&quot;Render process killed&quot;</span>);
              <span class="keyword">break</span>;
          }
          <span class="type">QMessageBox</span><span class="operator">::</span>StandardButton btn <span class="operator">=</span> <span class="type">QMessageBox</span><span class="operator">::</span>question(window()<span class="operator">,</span> status<span class="operator">,</span>
                                                     tr(<span class="string">&quot;Render process exited with code: %1\n&quot;</span>
                                                        <span class="string">&quot;Do you want to reload the page ?&quot;</span>)<span class="operator">.</span>arg(statusCode));
          <span class="keyword">if</span> (btn <span class="operator">=</span><span class="operator">=</span> <span class="type">QMessageBox</span><span class="operator">::</span>Yes)
              <span class="type">QTimer</span><span class="operator">::</span>singleShot(<span class="number">0</span><span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">]</span> { reload(); });
      });
  }

  <span class="type">void</span> WebView<span class="operator">::</span>setPage(WebPage <span class="operator">*</span>page)
  {
      createWebActionTrigger(page<span class="operator">,</span><span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>Forward);
      createWebActionTrigger(page<span class="operator">,</span><span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>Back);
      createWebActionTrigger(page<span class="operator">,</span><span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>Reload);
      createWebActionTrigger(page<span class="operator">,</span><span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>Stop);
      <span class="type"><a href="qwebengineview.html">QWebEngineView</a></span><span class="operator">::</span>setPage(page);
  }

  <span class="type">int</span> WebView<span class="operator">::</span>loadProgress() <span class="keyword">const</span>
  {
      <span class="keyword">return</span> m_loadProgress;
  }

  <span class="type">void</span> WebView<span class="operator">::</span>createWebActionTrigger(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span> <span class="operator">*</span>page<span class="operator">,</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebAction webAction)
  {
      <span class="type">QAction</span> <span class="operator">*</span>action <span class="operator">=</span> page<span class="operator">-</span><span class="operator">&gt;</span>action(webAction);
      connect(action<span class="operator">,</span> <span class="operator">&amp;</span><span class="type">QAction</span><span class="operator">::</span>changed<span class="operator">,</span> <span class="operator">[</span><span class="keyword">this</span><span class="operator">,</span> action<span class="operator">,</span> webAction<span class="operator">]</span>{
          <span class="keyword">emit</span> webActionEnabledChanged(webAction<span class="operator">,</span> action<span class="operator">-</span><span class="operator">&gt;</span>isEnabled());
      });
  }

  bool WebView<span class="operator">::</span>isWebActionEnabled(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebAction webAction) <span class="keyword">const</span>
  {
      <span class="keyword">return</span> page()<span class="operator">-</span><span class="operator">&gt;</span>action(webAction)<span class="operator">-</span><span class="operator">&gt;</span>isEnabled();
  }

  <span class="type">QIcon</span> WebView<span class="operator">::</span>favIcon() <span class="keyword">const</span>
  {
      <span class="type">QIcon</span> favIcon <span class="operator">=</span> icon();
      <span class="keyword">if</span> (<span class="operator">!</span>favIcon<span class="operator">.</span>isNull())
          <span class="keyword">return</span> favIcon;

      <span class="keyword">if</span> (m_loadProgress <span class="operator">&lt;</span> <span class="number">0</span>) {
          <span class="keyword">static</span> <span class="type">QIcon</span> errorIcon(<span class="type">QStringLiteral</span>(<span class="string">&quot;:dialog-error.png&quot;</span>));
          <span class="keyword">return</span> errorIcon;
      } <span class="keyword">else</span> <span class="keyword">if</span> (m_loadProgress <span class="operator">&lt;</span> <span class="number">100</span>) {
          <span class="keyword">static</span> <span class="type">QIcon</span> loadingIcon(<span class="type">QStringLiteral</span>(<span class="string">&quot;:view-refresh.png&quot;</span>));
          <span class="keyword">return</span> loadingIcon;
      } <span class="keyword">else</span> {
          <span class="keyword">static</span> <span class="type">QIcon</span> defaultIcon(<span class="type">QStringLiteral</span>(<span class="string">&quot;:text-html.png&quot;</span>));
          <span class="keyword">return</span> defaultIcon;
      }
  }

  <span class="type"><a href="qwebengineview.html">QWebEngineView</a></span> <span class="operator">*</span>WebView<span class="operator">::</span>createWindow(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebWindowType type)
  {
      BrowserWindow <span class="operator">*</span>mainWindow <span class="operator">=</span> qobject_cast<span class="operator">&lt;</span>BrowserWindow<span class="operator">*</span><span class="operator">&gt;</span>(window());
      <span class="keyword">if</span> (<span class="operator">!</span>mainWindow)
          <span class="keyword">return</span> nullptr;

      <span class="keyword">switch</span> (type) {
      <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebBrowserTab: {
          <span class="keyword">return</span> mainWindow<span class="operator">-</span><span class="operator">&gt;</span>tabWidget()<span class="operator">-</span><span class="operator">&gt;</span>createTab();
      }
      <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebBrowserBackgroundTab: {
          <span class="keyword">return</span> mainWindow<span class="operator">-</span><span class="operator">&gt;</span>tabWidget()<span class="operator">-</span><span class="operator">&gt;</span>createBackgroundTab();
      }
      <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebBrowserWindow: {
          <span class="keyword">return</span> mainWindow<span class="operator">-</span><span class="operator">&gt;</span>browser()<span class="operator">-</span><span class="operator">&gt;</span>createWindow()<span class="operator">-</span><span class="operator">&gt;</span>currentTab();
      }
      <span class="keyword">case</span> <span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>WebDialog: {
          WebPopupWindow <span class="operator">*</span>popup <span class="operator">=</span> <span class="keyword">new</span> WebPopupWindow(page()<span class="operator">-</span><span class="operator">&gt;</span>profile());
          <span class="keyword">return</span> popup<span class="operator">-</span><span class="operator">&gt;</span>view();
      }
      }
      <span class="keyword">return</span> nullptr;
  }

  <span class="type">void</span> WebView<span class="operator">::</span>contextMenuEvent(<span class="type">QContextMenuEvent</span> <span class="operator">*</span>event)
  {
      <span class="type">QMenu</span> <span class="operator">*</span>menu <span class="operator">=</span> page()<span class="operator">-</span><span class="operator">&gt;</span>createStandardContextMenu();
      <span class="keyword">const</span> <span class="type">QList</span><span class="operator">&lt;</span><span class="type">QAction</span><span class="operator">*</span><span class="operator">&gt;</span> actions <span class="operator">=</span> menu<span class="operator">-</span><span class="operator">&gt;</span>actions();
      <span class="keyword">auto</span> it <span class="operator">=</span> std<span class="operator">::</span>find(actions<span class="operator">.</span>cbegin()<span class="operator">,</span> actions<span class="operator">.</span>cend()<span class="operator">,</span> page()<span class="operator">-</span><span class="operator">&gt;</span>action(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>OpenLinkInThisWindow));
      <span class="keyword">if</span> (it <span class="operator">!</span><span class="operator">=</span> actions<span class="operator">.</span>cend()) {
          (<span class="operator">*</span>it)<span class="operator">-</span><span class="operator">&gt;</span>setText(tr(<span class="string">&quot;Open Link in This Tab&quot;</span>));
          <span class="operator">+</span><span class="operator">+</span>it;
          <span class="type">QAction</span> <span class="operator">*</span>before(it <span class="operator">=</span><span class="operator">=</span> actions<span class="operator">.</span>cend() <span class="operator">?</span> nullptr : <span class="operator">*</span>it);
          menu<span class="operator">-</span><span class="operator">&gt;</span>insertAction(before<span class="operator">,</span> page()<span class="operator">-</span><span class="operator">&gt;</span>action(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>OpenLinkInNewWindow));
          menu<span class="operator">-</span><span class="operator">&gt;</span>insertAction(before<span class="operator">,</span> page()<span class="operator">-</span><span class="operator">&gt;</span>action(<span class="type"><a href="qwebenginepage.html">QWebEnginePage</a></span><span class="operator">::</span>OpenLinkInNewTab));
      }
      menu<span class="operator">-</span><span class="operator">&gt;</span>popup(event<span class="operator">-</span><span class="operator">&gt;</span>globalPos());
  }

</pre>
</div>
<!-- @@@webenginewidgets/simplebrowser/webview.cpp -->
        </div>
       </div>
   </div>
   </div>
</div>
<div class="footer">
   <p>
   <acronym title="Copyright">&copy;</acronym> 2017 The Qt Company Ltd.
   Documentation contributions included herein are the copyrights of
   their respective owners.<br>    The documentation provided herein is licensed under the terms of the    <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation    License version 1.3</a> as published by the Free Software Foundation.<br>    Qt and respective logos are trademarks of The Qt Company Ltd.     in Finland and/or other countries worldwide. All other trademarks are property
   of their respective owners. </p>
</div>
</body>
</html>