/usr/share/qt5/doc/qtpositioning/qml-geoshape.html is in qtlocation5-doc-html 5.2.1-1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qdeclarativegeoshape.cpp -->
<title>QML Basic Type: geoshape | QtPositioning 5.2</title>
<link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul>
<li>Qt 5.2</li>
<li><a href="qtpositioning-index.html">Qt Positioning</a></li>
<li><a href="qtpositioning-qmlmodule.html">QML Types</a></li>
<li>QML Basic Type: geoshape</li>
<li id="buildversion">
Qt 5.2.1 Reference Documentation</li>
</ul>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level2"><a href="#example-usage">Example Usage</a></li>
<li class="level2"><a href="#properties">Properties</a></li>
<li class="level3"><a href="#isempty">isEmpty</a></li>
<li class="level3"><a href="#isvalid">isValid</a></li>
<li class="level2"><a href="#methods">Methods</a></li>
<li class="level3"><a href="#contains">contains()</a></li>
</ul>
</div>
<h1 class="title">QML Basic Type: geoshape</h1>
<span class="subtitle"></span>
<!-- $$$geoshape-description -->
<div class="descr"> <a name="details"></a>
<p>The <tt>geoshape</tt> type represents an abstract geographic area. It includes attributes and methods common to all geographic areas. To create objects that represent a valid geographic area use <a href="qml-georectangle.html">georectangle</a> or <a href="qml-geocircle.html">geocircle</a>.</p>
<p>The <a href="#isvalid">isValid</a> attribute can be used to test if the geoshape represents a valid geographic area.</p>
<p>The <a href="#isempty">isEmpty</a> attribute can be used to test if the geoshape represents a region with a geomatrical area of 0.</p>
<p>The <a href="#contains">contains()</a> method can be used to test if a <a href="qml-coordinate.html">coordinate</a> is within the geoshape.</p>
<a name="example-usage"></a>
<h3>Example Usage</h3>
<p>Use properties of type variant to store a <tt>geoshape</tt>. To create a <tt>geoshape</tt> use one of the methods described below.</p>
<p>To create a <tt>geoshape</tt> value, specify it as a "shape()" string:</p>
<pre class="qml">import QtPositioning
<span class="type">Item</span> {
property <span class="type">variant</span> <span class="name">region</span>: <span class="string">"shape()"</span>
}</pre>
<p>or with the <a href="qml-qtpositioning-qtpositioning.html#shape-method">QtPositioning.shape()</a> function:</p>
<pre class="qml">import QtPositioning 5.2
<span class="type">Item</span> {
property <span class="type">variant</span> <span class="name">region</span>: <span class="name">QtPositioning</span>.<span class="name">shape</span>()
}</pre>
<p>When integrating with C++, note that any <a href="qgeoshape.html">QGeoShape</a> value passed into QML from C++ is automatically converted into a <tt>geoshape</tt> value, and vice-versa.</p>
<a name="properties"></a>
<h3>Properties</h3>
<a name="isempty"></a>
<h4>isEmpty</h4>
<pre class="cpp">bool isEmpty</pre>
<p>Returns whether this geo shape is empty. An empty geo shape is a region which has a geometrical area of 0.</p>
<a name="isvalid"></a>
<h4>isValid</h4>
<pre class="cpp">bool isValid</pre>
<p>Returns whether this geo shape is valid.</p>
<p>A geo shape is considered to be invalid if some of the data that is required to unambiguously describe the geo shape has not been set or has been set to an unsuitable value.</p>
<a name="methods"></a>
<h3>Methods</h3>
<a name="contains"></a>
<h4>contains()</h4>
<pre class="cpp">bool contains(coordinate coord)</pre>
<p>Returns true if the <a href="qml-qtpositioning-qtpositioning.html#coordinate-method">coordinate</a> specified by <i>coord</i> is within this geoshape; Otherwise returns false.</p>
</div>
<!-- @@@geoshape -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2013 Digia Plc and/or its
subsidiaries. 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> Digia, Qt and their respective logos are trademarks of Digia Plc in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
|