Provides a list of API Elements (Classes, Enums, etc)

You can filter the list using the field names of an Element, optionally
with a Django QuerySet suffix such as <field>__icontains
GET /api/service/elements/?namespace__name=Ubuntu.Components
HTTP 200 OK Vary: Accept Content-Type: text/html; charset=utf-8 Allow: GET, POST, HEAD, OPTIONS
[ { "url": "http://developer.ubuntu.com/api/service/elements/149/", "name": "AbstractButton", "description": "The AbstractButton class defines the behavior of the button. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.AbstractButton", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$AbstractButton-brief -->\n<p>The AbstractButton class defines the behavior of the button. <a href=\"#details\">More...</a></p>\n<!-- @@@AbstractButton -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.CheckBox/\">CheckBox</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ListItems.Empty/\">Empty</a>, and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Pickers.PickerDelegate/\">PickerDelegate</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#clicked-signal\">clicked</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#pressAndHold-signal\">pressAndHold</a></b></b>()</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onClicked-signal-handler\">onClicked</a></b></b>()</li>\n</ul>\n<!-- $$$AbstractButton-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>This class defines the behavior of the button: it defines the MouseArea and the states.</p>\n<!-- @@@AbstractButton -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> associated with this <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.iconSource.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$clicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clicked-signal\"></a>AbstractButton::<span class=\"name\">clicked</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when there is a mouse click on the button and the button is not disabled. If <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">action</a> is defined, the action will be triggered.</p>\n</div></div><!-- @@@clicked -->\n<br/>\n<!-- $$$pressAndHold -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"pressAndHold-signal\"></a>AbstractButton::<span class=\"name\">pressAndHold</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when there is a long press.</p>\n</div></div><!-- @@@pressAndHold -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onClicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onClicked-signal-handler\"></a>AbstractButton::<span class=\"name\">onClicked</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>If a button is clicked, its triggered() signal will automatically be called.</p>\n</div></div><!-- @@@onClicked -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/457/", "name": "AbstractButton", "description": "The AbstractButton class defines the behavior of the button. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.AbstractButton", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$AbstractButton-brief -->\n<p>The AbstractButton class defines the behavior of the button. <a href=\"#details\">More...</a></p>\n<!-- @@@AbstractButton -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.CheckBox\">CheckBox</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ListItems.Empty\">Empty</a>, and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.PickerDelegate\">PickerDelegate</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#clicked-signal\">clicked</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#pressAndHold-signal\">pressAndHold</a></b></b>()</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onClicked-signal-handler\">onClicked</a></b></b>()</li>\n</ul>\n<!-- $$$AbstractButton-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>This class defines the behavior of the button: it defines the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> and the states. All components deriving from this class support haptic feedback out of the box.</p>\n<!-- @@@AbstractButton -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> associated with this <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the actionItem in the ubuntu-mobile icon theme. Default value: action.iconName.</p>\n<p>If both <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the actionItem. Default value: action.iconSource.</p>\n<p>If both iconSource and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> are defined, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> will be ignored.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the actionItem. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$clicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clicked-signal\"></a>AbstractButton::<span class=\"name\">clicked</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when there is a mouse click on the button and the button is not disabled. If <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">action</a> is defined, the action will be triggered.</p>\n</div></div><!-- @@@clicked -->\n<br/>\n<!-- $$$pressAndHold -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"pressAndHold-signal\"></a>AbstractButton::<span class=\"name\">pressAndHold</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when there is a long press.</p>\n</div></div><!-- @@@pressAndHold -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onClicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onClicked-signal-handler\"></a>AbstractButton::<span class=\"name\">onClicked</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>If a button is clicked, its triggered() signal will automatically be called.</p>\n</div></div><!-- @@@onClicked -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-abstractbutton.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/150/", "name": "Action", "description": "Describe an action that can be re-used in, for example a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a> ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Action", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Action-brief -->\n<p>Describe an action that can be re-used in, for example a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a> <a href=\"#details\">More...</a></p>\n<!-- @@@Action -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#itemHint-prop\">itemHint</a></b></b> : Component<tt> (deprecated)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#visible-prop\">visible</a></b></b> : bool<tt> (deprecated)</tt></li>\n</ul>\n<!-- $$$Action-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>Examples: See <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></p>\n<!-- @@@Action -->\n<h2>Property Documentation</h2>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the action.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$itemHint -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"itemHint-prop\"></a><span class=\"name\">itemHint</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p><b>itemHint is DEPRECATED. Use <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> to specify the representation of an <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>.</b></p>\n</div></div><!-- @@@itemHint -->\n<br/>\n<!-- $$$visible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"visible-prop\"></a><span class=\"name\">visible</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p><b>visible is DEPRECATED. Use <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> to specify the representation of an <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>.</b> The action is visible to the user</p>\n</div></div><!-- @@@visible -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/458/", "name": "Action", "description": "Describe an action that can be re-used in, for example a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a> ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Action", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Action-brief -->\n<p>Describe an action that can be re-used in, for example a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a> <a href=\"#details\">More...</a></p>\n<!-- @@@Action -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#itemHint-prop\">itemHint</a></b></b> : Component<tt> (deprecated)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#visible-prop\">visible</a></b></b> : bool<tt> (deprecated)</tt></li>\n</ul>\n<!-- $$$Action-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>Examples: See <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></p>\n<!-- @@@Action -->\n<h2>Property Documentation</h2>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the action.</p>\n<p>This is the name of the icon in the ubuntu-mobile theme. If both <a href=\"#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span> {\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n}</pre>\n<p><b>Note: </b>The complete list of icons available in Ubuntu is not published yet. For now please refer to the folder where the icon theme is installed:</p><ul>\n<li>Ubuntu Touch: <a href=\"file:/usr/share/icons/ubuntu-mobile\">/usr/share/icons/ubuntu-mobile</a></li>\n</ul>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the action.</p>\n<p>This is a URL to any image file. In order to use an icon from the Ubuntu theme, use the <a href=\"#iconName-prop\">iconName</a> property instead.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$itemHint -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"itemHint-prop\"></a><span class=\"name\">itemHint</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p><b>itemHint is DEPRECATED. Use <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> to specify the representation of an <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>.</b></p>\n</div></div><!-- @@@itemHint -->\n<br/>\n<!-- $$$visible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"visible-prop\"></a><span class=\"name\">visible</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p><b>visible is DEPRECATED. Use <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> to specify the representation of an <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>.</b> The action is visible to the user</p>\n</div></div><!-- @@@visible -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-action.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/459/", "name": "ActionItem", "description": "A visual representation of an Action. The API of ActionItem is a copy of the API of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>, with additional properties to define visual aspects of the ActionItem. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.ActionItem", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActionItem-brief -->\n<p>A visual representation of an Action. The API of ActionItem is a copy of the API of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>, with additional properties to define visual aspects of the ActionItem. <a href=\"#details\">More...</a></p>\n<!-- @@@ActionItem -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.AbstractButton\">AbstractButton</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a>, and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#triggered-signal\">triggered</a></b></b>(var <i>value</i>)</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onTriggered-signal-handler\">onTriggered</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#trigger-method\">trigger</a></b></b>(<i>value</i>)</li>\n</ul>\n<!-- $$$ActionItem-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>If <a href=\"#action-prop\">action</a> is set, the values of the other properties will by default be identical to the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>'s property values. Setting the other properties will override the properties copied from the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a>.</p>\n<p>See <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarItems\">ToolbarItems</a> for examples of how to use <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a> or other ActionItems in a toolbar.</p>\n<!-- @@@ActionItem -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> associated with this <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the actionItem in the ubuntu-mobile icon theme. Default value: action.iconName.</p>\n<p>If both <a href=\"#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the actionItem. Default value: action.iconSource.</p>\n<p>If both iconSource and <a href=\"#iconName-prop\">iconName</a> are defined, <a href=\"#iconName-prop\">iconName</a> will be ignored.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the actionItem. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$triggered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"triggered-signal\"></a>ActionItem::<span class=\"name\">triggered</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span><i> value</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Called when the actionItem is triggered.</p>\n</div></div><!-- @@@triggered -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onTriggered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onTriggered-signal-handler\"></a>ActionItem::<span class=\"name\">onTriggered</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>If <a href=\"#action-prop\">action</a> is set, this will trigger it.</p>\n</div></div><!-- @@@onTriggered -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$trigger -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"trigger-method\"></a>ActionItem::<span class=\"name\">trigger</span>(<i> value</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Trigger this action item if it is enabled.</p>\n</div></div><!-- @@@trigger -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-actionitem.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/151/", "name": "ActionItem", "description": "A visual representation of an Action. The API of ActionItem is a copy of the API of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>, with additional properties to define visual aspects of the ActionItem. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.ActionItem", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActionItem-brief -->\n<p>A visual representation of an Action. The API of ActionItem is a copy of the API of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>, with additional properties to define visual aspects of the ActionItem. <a href=\"#details\">More...</a></p>\n<!-- @@@ActionItem -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.AbstractButton/\">AbstractButton</a> and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#triggered-signal\">triggered</a></b></b>(var <i>value</i>)</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onTriggered-signal-handler\">onTriggered</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#trigger-method\">trigger</a></b></b>(<i>value</i>)</li>\n</ul>\n<!-- $$$ActionItem-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>If <a href=\"#action-prop\">action</a> is set, the values of the other properties will by default be identical to the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>'s property values. Setting the other properties will override the properties copied from the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a>.</p>\n<p>See <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarItems/\">ToolbarItems</a> for examples of how to use <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a> or other ActionItems in a toolbar.</p>\n<!-- @@@ActionItem -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> associated with this <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.iconSource.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$triggered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"triggered-signal\"></a>ActionItem::<span class=\"name\">triggered</span>(<span class=\"type\">var</span><i> value</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Called when the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a> is triggered.</p>\n</div></div><!-- @@@triggered -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onTriggered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onTriggered-signal-handler\"></a>ActionItem::<span class=\"name\">onTriggered</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>If <a href=\"#action-prop\">action</a> is set, this will trigger it.</p>\n</div></div><!-- @@@onTriggered -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$trigger -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"trigger-method\"></a>ActionItem::<span class=\"name\">trigger</span>(<i> value</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Trigger this action item if it is enabled.</p>\n</div></div><!-- @@@trigger -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/460/", "name": "ActionList", "description": "List of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> items ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.ActionList", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActionList-brief -->\n<p>List of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> items <a href=\"#details\">More...</a></p>\n<!-- @@@ActionList -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQml.QtObject\">QtObject</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#children-prop\">children</a></b></b> : list&lt;Action&gt;</li>\n</ul>\n<!-- $$$ActionList-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<!-- @@@ActionList -->\n<h2>Property Documentation</h2>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>List of already defined actions when not defining them as children of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionList\">ActionList</a>. Note that when you set this property, the children of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionList\">ActionList</a> will be ignored, so do not set the list and define children.</p>\n<p>The advantage of setting actions over using the children is that the same <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> items can be used in several sets of actions.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$children -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"children-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">children</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\">Action</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Default property to allow adding of children.</p>\n</div></div><!-- @@@children -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-actionlist.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/152/", "name": "ActionList", "description": "List of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> items ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.ActionList", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActionList-brief -->\n<p>List of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> items <a href=\"#details\">More...</a></p>\n<!-- @@@ActionList -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#children-prop\">children</a></b></b> : list&lt;Action&gt;</li>\n</ul>\n<!-- $$$ActionList-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<!-- @@@ActionList -->\n<h2>Property Documentation</h2>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>List of already defined actions when not defining them as children of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionList/\">ActionList</a>. Note that when you set this property, the children of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionList/\">ActionList</a> will be ignored, so do not set the list and define children.</p>\n<p>The advantage of setting actions over using the children is that the same <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> items can be used in several sets of actions.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$children -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"children-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">children</span> : <span class=\"type\">list</span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Default property to allow adding of children.</p>\n</div></div><!-- @@@children -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/462/", "name": "ActivityIndicator", "description": "The ActivityIndicator component visually indicates that a task of unknown duration is in progress, e.g&#x2e; busy indication, connection in progress indication, etc. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.ActivityIndicator", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActivityIndicator-brief -->\n<p>The ActivityIndicator component visually indicates that a task of unknown duration is in progress, e.g&#x2e; busy indication, connection in progress indication, etc. <a href=\"#details\">More...</a></p>\n<!-- @@@ActivityIndicator -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#running-prop\">running</a></b></b> : bool<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$ActivityIndicator-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Note: for time consuming JavaScript operations use <a href=\"/api/qml/sdk-14.04/QtQml.WorkerScript\">WorkerScript</a>, otherwise no UI interaction will be possible and the ActicityIndicator animation will freeze.</p>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">ActivityIndicator</span> {\n <span class=\"name\">id</span>: <span class=\"name\">activity</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">toggleActive</span>\n <span class=\"name\">text</span>: (<span class=\"name\">activity</span>.<span class=\"name\">running</span>) ? <span class=\"string\">&quot;Deactivate&quot;</span> : <span class=\"string\">&quot;Activate&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">activity</span>.<span class=\"name\">running</span> <span class=\"operator\">=</span> !<span class=\"name\">activity</span>.<span class=\"name\">running</span>\n }\n}</pre>\n<!-- @@@ActivityIndicator -->\n<h2>Property Documentation</h2>\n<!-- $$$running -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"running-prop\"></a><span class=\"name\">running</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Presents whether there is activity to be visualized or not. The default value is false. When activated (set to true), an animation is shown indicating an ongoing activity, which continues until deactivated (set to false).</p>\n</div></div><!-- @@@running -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-activityindicator.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/154/", "name": "ActivityIndicator", "description": "The ActivityIndicator component visually indicates that a task of unknown duration is in progress, e.g&#x2e; busy indication, connection in progress indication, etc. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.ActivityIndicator", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ActivityIndicator-brief -->\n<p>The ActivityIndicator component visually indicates that a task of unknown duration is in progress, e.g&#x2e; busy indication, connection in progress indication, etc. <a href=\"#details\">More...</a></p>\n<!-- @@@ActivityIndicator -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#running-prop\">running</a></b></b> : bool<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$ActivityIndicator-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Note: for time consuming JavaScript operations use WorkerScript, otherwise no UI interaction will be possible and the ActicityIndicator animation will freeze.</p>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">ActivityIndicator</span> {\n <span class=\"name\">id</span>: <span class=\"name\">activity</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">toggleActive</span>\n <span class=\"name\">text</span>: (<span class=\"name\">activity</span>.<span class=\"name\">running</span>) ? <span class=\"string\">&quot;Deactivate&quot;</span> : <span class=\"string\">&quot;Activate&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">activity</span>.<span class=\"name\">running</span> <span class=\"operator\">=</span> !<span class=\"name\">activity</span>.<span class=\"name\">running</span>\n }\n}</pre>\n<!-- @@@ActivityIndicator -->\n<h2>Property Documentation</h2>\n<!-- $$$running -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"running-prop\"></a><span class=\"name\">running</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Presents whether there is activity to be visualized or not. The default value is false. When activated (set to true), an animation is shown indicating an ongoing activity, which continues until deactivated (set to false).</p>\n</div></div><!-- @@@running -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/520/", "name": "Alarm", "description": "Alarm component is a representation of an alarm event. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Alarm", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Alarm-brief -->\n<p>Alarm component is a representation of an alarm event. <a href=\"#details\">More...</a></p>\n<!-- @@@Alarm -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#date-prop\">date</a></b></b> : Date</li>\n<li class=\"fn\"><b><b><a href=\"#daysOfWeek-prop\">daysOfWeek</a></b></b> : DaysOfWeek</li>\n<li class=\"fn\"><b><b><a href=\"#enabled-prop\">enabled</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#error-prop\">error</a></b></b> : Error</li>\n<li class=\"fn\"><b><b><a href=\"#message-prop\">message</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#sound-prop\">sound</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#status-prop\">status</a></b></b> : Status</li>\n<li class=\"fn\"><b><b><a href=\"#type-prop\">type</a></b></b> : AlarmType</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#cancel-method\">cancel</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#reset-method\">reset</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#save-method\">save</a></b></b>()</li>\n</ul>\n<!-- $$$Alarm-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The Alarm element encapsulates alarm event data. Supports one time and repeating alarms, where repeating can be either daily or weekly on one or several selected days.</p>\n<p>The alarm data is validated upon <a href=\"#save-method\">save</a> operation, which can be used to save a new alarm or update existing alarm's properties.</p>\n<p>During data validation the alarm properties may suffer changes. These changes will be reported back to each changed property. See what changes can occurr at <a href=\"#save-method\">save</a> function documentation.</p>\n<p>Example usage:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"type\">Alarm</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarm</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Column\">Column</a></span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Row\">Row</a></span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">date</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Date:&quot;</span>\n <span class=\"name\">anchors</span>.verticalCenter: <span class=\"name\">parent</span>.<span class=\"name\">verticalCenter</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"name\">alarm</span>.<span class=\"name\">date</span>.<span class=\"name\">toString</span>()\n <span class=\"name\">onAccepted</span>: <span class=\"name\">alarm</span>.<span class=\"name\">date</span> <span class=\"operator\">=</span> new <span class=\"name\">Date</span>(<span class=\"name\">text</span>)\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Row\">Row</a></span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">msg</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Message:&quot;</span>\n <span class=\"name\">anchors</span>.verticalCenter: <span class=\"name\">parent</span>.<span class=\"name\">verticalCenter</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"name\">alarm</span>.<span class=\"name\">message</span>\n <span class=\"name\">onAccepted</span>: <span class=\"name\">alarm</span>.<span class=\"name\">message</span> <span class=\"operator\">=</span> <span class=\"name\">text</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Save&quot;</span>\n <span class=\"name\">onClicked</span>: {\n <span class=\"name\">alarm</span>.<span class=\"name\">save</span>();\n <span class=\"keyword\">if</span> (<span class=\"name\">alarm</span>.<span class=\"name\">error</span> <span class=\"operator\">!=</span> <span class=\"name\">Alarm</span>.<span class=\"name\">NoError</span>)\n <span class=\"name\">print</span>(<span class=\"string\">&quot;Error saving alarm, code: &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">alarm</span>.<span class=\"name\">error</span>);\n }\n }\n }\n}</pre>\n<p>An alarm can be cancelled using <a href=\"#cancel-method\">cancel</a> function but only if the event has previously been stored in the alarm collection.</p>\n<p>The <a href=\"#reset-method\">reset</a> function clears the properties of the alarm bringing them to the default values. In this way the same alarm component can be used to save several alarms at the same time.</p>\n<!-- @@@Alarm -->\n<h2>Property Documentation</h2>\n<!-- $$$date -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"date-prop\"></a><span class=\"name\">date</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Date\">Date</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the date the alarm will be triggered. The default value is the current date and time the alarm object was created. Further <a href=\"#reset-method\">reset</a> calls will bring the value back to the time the <a href=\"#reset-method\">reset</a> was called.</p>\n</div></div><!-- @@@date -->\n<br/>\n<!-- $$$daysOfWeek -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"daysOfWeek-prop\"></a><span class=\"name\">daysOfWeek</span> : <span class=\"type\">DaysOfWeek</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the days of the week the alarm is scheduled. This property can have only one day set for one time alarms and multiple days for repeating alarms. The following flags can be set:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th colspan=\"3\" rowspan=\" 1\">Alarm.DayOfWeek enum:</th></tr>\n<tr class=\"qt-style\"><th >Type</th><th >Value</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Monday</td><td >0x01</td><td >The alarm will kick on Mondays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Tuesday</td><td >0x02</td><td >The alarm will kick on Tuesdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Wednesday</td><td >0x04</td><td >The alarm will kick on Wednesdays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Thursday</td><td >0x08</td><td >The alarm will kick on Thursdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Friday</td><td >0x10</td><td >The alarm will kick on Fridays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Saturday</td><td >0x20</td><td >The alarm will kick on Saturdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Sunday</td><td >0x40</td><td >The alarm will kick on Sundays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.AutoDetect</td><td >0x80</td><td >The alarm day will be detected from the alarm date.</td></tr>\n</table>\n<p>The default value is Alarm.AutoDetect.</p>\n</div></div><!-- @@@daysOfWeek -->\n<br/>\n<!-- $$$enabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"enabled-prop\"></a><span class=\"name\">enabled</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property specifies whether the alarm is enabled or not. Disable dalarms are not scheduled. The default value is true;</p>\n</div></div><!-- @@@enabled -->\n<br/>\n<!-- $$$error -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"error-prop\"></a><span class=\"name\">error</span> : <span class=\"type\">Error</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the error code occurred during the last performed operation.</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th >Error code</th><th >Value</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >NoError</td><td >0</td><td >Successful operation completion.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >InvalidDate</td><td >1</td><td >The date specified for the alarm was invalid.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >EarlyDate</td><td >2</td><td >The date specified for the alarm is an earlier date than the current one.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >NoDaysOfWeek</td><td >3</td><td >The <a href=\"#daysOfWeek-prop\">daysOfWeek</a> parameter of the alarm was not specified.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >OneTimeOnMoreDays</td><td >4</td><td >The one-time alarm was set to be kicked in several days.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >InvalidEvent</td><td >5</td><td >The alarm event is invalid.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >AdaptationError</td><td >100</td><td >The error occurred in alarm adaptation layer. Adaptations may define additional behind this value.</td></tr>\n</table>\n</div></div><!-- @@@error -->\n<br/>\n<!-- $$$message -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"message-prop\"></a><span class=\"name\">message</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the message string which will be displayed when the alarm is triggered. The default value is the localized &quot;Alarm&quot; text.</p>\n</div></div><!-- @@@message -->\n<br/>\n<!-- $$$sound -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"sound-prop\"></a><span class=\"name\">sound</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the alarm's sound to be played when the alarm is triggered. An empty url will mean to play the default sound.</p>\n<p>The defaul tvalue is an empty url.</p>\n</div></div><!-- @@@sound -->\n<br/>\n<!-- $$$status -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"status-prop\"></a><span class=\"name\">status</span> : <span class=\"type\">Status</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the status of the last performed operation. It can take one of the following values:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th >Status code</th><th >Value</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >Ready</td><td >1</td><td >Specifies either that the Alarm object is ready to perform any operation or that the previous operation has been successfully completed.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >InProgress</td><td >2</td><td >Specifies that there is an operation pending on Alarm object.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Fail</td><td >3</td><td >Specifies that the last alarm operation has failed. The failure code is set in <a href=\"#error-prop\">error</a> property.</td></tr>\n</table>\n<p>The notification signal has a parameter specifying the <i>operation</i> the status refers to. The operation can take the following values:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th >Operation code</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >NoOperation</td><td >There is no operation pending. This may be set when an error occured in the alarm adapters and the operation cannot be determined.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Saving</td><td >The status reported refers to an operation requested through <a href=\"#save-method\">save()</a>.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Canceling</td><td >The status reported refers to an operation requested through <a href=\"#cancel-method\">cancel()</a>.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Reseting</td><td >The status reported refers to an operation requested through <a href=\"#reset-method\">reset()</a>.</td></tr>\n</table>\n<p>For example an implementation which resets the alarm data whenever the save or cancel operations succeed would look as follows:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a></span> {\n <span class=\"name\">onStatusChanged</span>: {\n <span class=\"keyword\">if</span> (<span class=\"name\">status</span> <span class=\"operator\">!==</span> <span class=\"name\">Alarm</span>.<span class=\"name\">Ready</span>)\n <span class=\"keyword\">return</span>;\n <span class=\"keyword\">if</span> ((<span class=\"name\">operation</span> <span class=\"operator\">&gt;</span> <span class=\"name\">Alarm</span>.<span class=\"name\">NoOperation</span>) <span class=\"operator\">&amp;&amp;</span> (<span class=\"name\">operation</span> <span class=\"operator\">&lt;</span> <span class=\"name\">Alarm</span>.<span class=\"name\">Reseting</span>)) {\n <span class=\"name\">reset</span>();\n }\n }\n}</pre>\n</div></div><!-- @@@status -->\n<br/>\n<!-- $$$type -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"type-prop\"></a><span class=\"name\">type</span> : <span class=\"type\">AlarmType</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the type of the alarm, which can have one of the following values:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th colspan=\"2\" rowspan=\" 1\">Alarm.AlarmType enum:</th></tr>\n<tr class=\"qt-style\"><th >Type</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.OneTime</td><td >The alarm occurs only once.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Repeating</td><td >The alarm is a repeating one, either daily, weekly on a given day or on selected days.</td></tr>\n</table>\n<p>The default value is Alarm.OneTime.</p>\n</div></div><!-- @@@type -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$cancel -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"cancel-method\"></a>Alarm::<span class=\"name\">cancel</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function removes the alarm from the collection. The function will fail for alarms which are not yet registered to the collection.</p>\n<p>The operation is asynchronous, and its status is reported through the <a href=\"#status-prop\">status</a> property. Further operations should wait till the previous operation is completed. The operation result is stored in the <a href=\"#error-prop\">error</a> property.</p>\n</div></div><!-- @@@cancel -->\n<br/>\n<!-- $$$reset -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"reset-method\"></a>Alarm::<span class=\"name\">reset</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function resets the alarm properties to its defaults. After this call the object can be used to create a new alarm event.</p>\n<p><b>Note</b>: do not call this function on alarm objects retrieved from <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.AlarmModel\">AlarmModel</a>, as calling it will result in the model being out of sync from the alarm database.</p>\n</div></div><!-- @@@reset -->\n<br/>\n<!-- $$$save -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"save-method\"></a>Alarm::<span class=\"name\">save</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Updates or adds an alarm to the alarm collection. The operation aligns properties according to the following rules:</p>\n<ul>\n<li>- the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> will be set to the alarm day if the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> was set to Alarm.AutoDetect.</li>\n<li>- if the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> is set to a day other than the one specified in the <a href=\"#date-prop\">date</a> field, the <a href=\"#date-prop\">date</a> will be moved ahead to match the day from the <a href=\"#daysOfWeek-prop\">daysOfWeek</a>.</li>\n</ul>\n<p>The function will fail if</p>\n<ul>\n<li>- the <a href=\"#date-prop\">date</a> property is invalid</li>\n<li>- for one time alarm, the <a href=\"#date-prop\">date</a> property falue is earlier than the current time</li>\n<li>- the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> property is set to multiple days for one time alarm</li>\n</ul>\n<p>The operation is asynchronous, and its status is reported through the <a href=\"#status-prop\">status</a> property. Further operations should wait till the previous operation is completed. The operation result is stored in the <a href=\"#error-prop\">error</a> property.</p>\n</div></div><!-- @@@save -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-alarm.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/207/", "name": "Alarm", "description": "Alarm component is a representation of an alarm event. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Alarm", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Alarm-brief -->\n<p>Alarm component is a representation of an alarm event. <a href=\"#details\">More...</a></p>\n<!-- @@@Alarm -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#date-prop\">date</a></b></b> : Date</li>\n<li class=\"fn\"><b><b><a href=\"#daysOfWeek-prop\">daysOfWeek</a></b></b> : DaysOfWeek</li>\n<li class=\"fn\"><b><b><a href=\"#enabled-prop\">enabled</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#error-prop\">error</a></b></b> : Error</li>\n<li class=\"fn\"><b><b><a href=\"#message-prop\">message</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#sound-prop\">sound</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#status-prop\">status</a></b></b> : Status</li>\n<li class=\"fn\"><b><b><a href=\"#type-prop\">type</a></b></b> : AlarmType</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#cancel-method\">cancel</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#reset-method\">reset</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#save-method\">save</a></b></b>()</li>\n</ul>\n<!-- $$$Alarm-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The Alarm element encapsulates alarm event data. Supports one time and repeating alarms, where repeating can be either daily or weekly on one or several selected days.</p>\n<p>The alarm data is validated upon <a href=\"#save-method\">save</a> operation, which can be used to save a new alarm or update existing alarm's properties.</p>\n<p>During data validation the alarm properties may suffer changes. These changes will be reported back to each changed property. See what changes can occurr at <a href=\"#save-method\">save</a> function documentation.</p>\n<p>Example usage:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">Rectangle</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"type\">Alarm</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarm</span>\n }\n <span class=\"type\">Column</span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\">Row</span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">date</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Date:&quot;</span>\n <span class=\"name\">anchors</span>.verticalCenter: <span class=\"name\">parent</span>.<span class=\"name\">verticalCenter</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"name\">alarm</span>.<span class=\"name\">date</span>.<span class=\"name\">toString</span>()\n <span class=\"name\">onAccepted</span>: <span class=\"name\">alarm</span>.<span class=\"name\">date</span> <span class=\"operator\">=</span> new <span class=\"name\">Date</span>(<span class=\"name\">text</span>)\n }\n }\n <span class=\"type\">Row</span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">msg</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Message:&quot;</span>\n <span class=\"name\">anchors</span>.verticalCenter: <span class=\"name\">parent</span>.<span class=\"name\">verticalCenter</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"name\">alarm</span>.<span class=\"name\">message</span>\n <span class=\"name\">onAccepted</span>: <span class=\"name\">alarm</span>.<span class=\"name\">message</span> <span class=\"operator\">=</span> <span class=\"name\">text</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Save&quot;</span>\n <span class=\"name\">onClicked</span>: {\n <span class=\"name\">alarm</span>.<span class=\"name\">save</span>();\n <span class=\"keyword\">if</span> (<span class=\"name\">alarm</span>.<span class=\"name\">error</span> <span class=\"operator\">!=</span> <span class=\"name\">Alarm</span>.<span class=\"name\">NoError</span>)\n <span class=\"name\">print</span>(<span class=\"string\">&quot;Error saving alarm, code: &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">alarm</span>.<span class=\"name\">error</span>);\n <span class=\"keyword\">else</span> <span class=\"name\">alarm</span>.<span class=\"name\">reset</span>();\n }\n }\n }\n}</pre>\n<p>An alarm can be cancelled using <a href=\"#cancel-method\">cancel</a> function but only if the event has previously been stored in the alarm collection.</p>\n<p>The <a href=\"#reset-method\">reset</a> function clears the properties of the alarm bringing them to the default values. In this way the same alarm component can be used to save several alarms at the same time.</p>\n<!-- @@@Alarm -->\n<h2>Property Documentation</h2>\n<!-- $$$date -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"date-prop\"></a><span class=\"name\">date</span> : <span class=\"type\">Date</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the date the alarm will be triggered. The default value is the current date and time the alarm object was created. Further <a href=\"#reset-method\">reset</a> calls will bring the value back to the time the <a href=\"#reset-method\">reset</a> was called.</p>\n</div></div><!-- @@@date -->\n<br/>\n<!-- $$$daysOfWeek -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"daysOfWeek-prop\"></a><span class=\"name\">daysOfWeek</span> : <span class=\"type\">DaysOfWeek</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the days of the week the alarm is scheduled. This property can have only one day set for one time alarms and multiple days for repeating alarms. The following flags can be set:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th colspan=\"3\" rowspan=\" 1\">Alarm.DayOfWeek enum:</th></tr>\n<tr class=\"qt-style\"><th >Type</th><th >Value</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Monday</td><td >0x01</td><td >The alarm will kick on Mondays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Tuesday</td><td >0x02</td><td >The alarm will kick on Tuesdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Wednesday</td><td >0x04</td><td >The alarm will kick on Wednesdays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Thursday</td><td >0x08</td><td >The alarm will kick on Thursdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Friday</td><td >0x10</td><td >The alarm will kick on Fridays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Saturday</td><td >0x20</td><td >The alarm will kick on Saturdays.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.Sunday</td><td >0x40</td><td >The alarm will kick on Sundays.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.AutoDetect</td><td >0x80</td><td >The alarm day will be detected from the alarm date.</td></tr>\n</table>\n<p>The default value is Alarm.AutoDetect.</p>\n</div></div><!-- @@@daysOfWeek -->\n<br/>\n<!-- $$$enabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"enabled-prop\"></a><span class=\"name\">enabled</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property specifies whether the alarm is enabled or not. Disable dalarms are not scheduled. The default value is true;</p>\n</div></div><!-- @@@enabled -->\n<br/>\n<!-- $$$error -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"error-prop\"></a><span class=\"name\">error</span> : <span class=\"type\">Error</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the error code occurred during the last performed operation.</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th >Error code</th><th >Value</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >NoError</td><td >0</td><td >Successful operation completion.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >InvalidDate</td><td >1</td><td >The date specified for the alarm was invalid.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >EarlyDate</td><td >2</td><td >The date specified for the alarm is an earlier date than the current one.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >NoDaysOfWeek</td><td >3</td><td >The <a href=\"#daysOfWeek-prop\">daysOfWeek</a> parameter of the alarm was not specified.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >OneTimeOnMoreDays</td><td >4</td><td >The one-time alarm was set to be kicked in several days.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >InvalidEvent</td><td >5</td><td >The alarm event is invalid.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td >AdaptationError</td><td >100</td><td >The error occurred in alarm adaptation layer. Adaptations may define additional behind this value.</td></tr>\n</table>\n</div></div><!-- @@@error -->\n<br/>\n<!-- $$$message -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"message-prop\"></a><span class=\"name\">message</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the message string which will be displayed when the alarm is triggered. The default value is the localized &quot;Alarm&quot; text.</p>\n</div></div><!-- @@@message -->\n<br/>\n<!-- $$$sound -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"sound-prop\"></a><span class=\"name\">sound</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the alarm's sound to be played when the alarm is triggered. An empty url will mean to play the default sound.</p>\n<p>The defaul tvalue is an empty url.</p>\n</div></div><!-- @@@sound -->\n<br/>\n<!-- $$$status -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"status-prop\"></a><span class=\"name\">status</span> : <span class=\"type\">Status</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the status of the last performed operation.</p>\n</div></div><!-- @@@status -->\n<br/>\n<!-- $$$type -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"type-prop\"></a><span class=\"name\">type</span> : <span class=\"type\">AlarmType</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the type of the alarm, which can have one of the following values:</p>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th colspan=\"2\" rowspan=\" 1\">Alarm.AlarmType enum:</th></tr>\n<tr class=\"qt-style\"><th >Type</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td >Alarm.OneTime</td><td >The alarm occurs only once.</td></tr>\n<tr valign=\"top\" class=\"even\"><td >Alarm.Repeating</td><td >The alarm is a repeating one, either daily, weekly on a given day or on selected days.</td></tr>\n</table>\n<p>The default value is Alarm.OneTime.</p>\n</div></div><!-- @@@type -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$cancel -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"cancel-method\"></a>Alarm::<span class=\"name\">cancel</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function removes the alarm from the collection. The function will fail for alarms which are not yet registered to the collection.</p>\n<p>The operation result is stored in the <a href=\"#error-prop\">error</a> property.</p>\n</div></div><!-- @@@cancel -->\n<br/>\n<!-- $$$reset -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"reset-method\"></a>Alarm::<span class=\"name\">reset</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function resets the alarm properties to its defaults. After this call the object can be used to create a new alarm event.</p>\n</div></div><!-- @@@reset -->\n<br/>\n<!-- $$$save -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"save-method\"></a>Alarm::<span class=\"name\">save</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Updates or adds an alarm to the alarm collection. The operation aligns properties according to the following rules:</p>\n<ul>\n<li>- the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> will be set to the alarm day if the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> was set to Alarm.AutoDetect.</li>\n<li>- if the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> is set to a day other than the one specified in the <a href=\"#date-prop\">date</a> field, the <a href=\"#date-prop\">date</a> will be moved ahead to match the day from the <a href=\"#daysOfWeek-prop\">daysOfWeek</a>.</li>\n</ul>\n<p>The function will fail if</p>\n<ul>\n<li>- the <a href=\"#date-prop\">date</a> property is invalid</li>\n<li>- for one time alarm, the <a href=\"#date-prop\">date</a> property falue is earlier than the current time</li>\n<li>- the <a href=\"#daysOfWeek-prop\">daysOfWeek</a> property is set to multiple days for one time alarm</li>\n</ul>\n<p>The operation result is stored in the <a href=\"#error-prop\">error</a> property.</p>\n</div></div><!-- @@@save -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/521/", "name": "AlarmModel", "description": "AlarmModel holds the list of alarms defined. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.AlarmModel", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$AlarmModel-brief -->\n<p>AlarmModel holds the list of alarms defined. <a href=\"#details\">More...</a></p>\n<!-- @@@AlarmModel -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#count-prop\">count</a></b></b> : int</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">Alarm <b><b><a href=\"#get-method\">get</a></b></b>(int <i>index</i>)</li>\n</ul>\n<!-- $$$AlarmModel-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The AlarmModel is a simple container of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a> definitions stored in the alarm collection. The data provided by the model are read only, adding, modifying or removing data is only possible through <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a> functions. Any modification on the alarms or any new alarm added to the collection will refresh all the model instances. This also means that the delegates visualizing the model elements will also be re-created.</p>\n<p>Example usage:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span> {}\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">100</span>)\n <span class=\"name\">delegate</span>: <span class=\"name\">Subtitled</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">subText</span>: <span class=\"name\">Qt</span>.<span class=\"name\">formatDateTime</span>(<span class=\"name\">date</span>)\n }\n}</pre>\n<p>The model defines the same roles as the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a> properties. Note that the use of <i>enabled</i> role in delegates may be ambiguous. Therefore the model defines the additional role called <i>model</i>, which represents the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a> object from the index the delegate is showing the data, so the <i>enabled</i> role can then be accessed by simply dereferencing the model i.e&#x2e; model.enabled.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{}\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n }\n }\n}</pre>\n<p>The number of alarm events can be obtained from the <a href=\"#count-prop\">count</a> property. To get a specific alarm event data from the model, use the <a href=\"#get-method\">get()</a> function.</p>\n<p>As the <a href=\"#get-method\">get()</a> function returns the alarm object from the given index. Combined with the alarm functions the alarms can be updated in place.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarmModel</span>\n }\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n <span class=\"name\">onCheckedChanged</span>: {\n <span class=\"keyword\">if</span> (<span class=\"name\">checked</span> <span class=\"operator\">!=</span> <span class=\"name\">model</span>.<span class=\"name\">enabled</span>) {\n var <span class=\"name\">data</span> = <span class=\"name\">alarmModel</span>.<span class=\"name\">get</span>(<span class=\"name\">index</span>);\n <span class=\"name\">data</span>.<span class=\"name\">enabled</span> <span class=\"operator\">=</span> <span class=\"name\">checked</span>;\n <span class=\"name\">data</span>.<span class=\"name\">save</span>();\n }\n }\n }\n }\n}</pre>\n<p>In this kind of &quot;in place&quot; updates using the <i>model</i> role would give the same result:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarmModel</span>\n }\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n <span class=\"name\">onCheckedChanged</span>: {\n <span class=\"keyword\">if</span> (<span class=\"name\">checked</span> <span class=\"operator\">!=</span> <span class=\"name\">model</span>.<span class=\"name\">enabled</span>) {\n <span class=\"name\">model</span>.<span class=\"name\">enabled</span> <span class=\"operator\">=</span> <span class=\"name\">checked</span>;\n <span class=\"name\">model</span>.<span class=\"name\">save</span>();\n }\n }\n }\n }\n}</pre>\n<!-- @@@AlarmModel -->\n<h2>Property Documentation</h2>\n<!-- $$$count -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"count-prop\"></a><span class=\"name\">count</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The number of data entries in the model.</p>\n</div></div><!-- @@@count -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$get -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"get-method\"></a><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a></span> AlarmModel::<span class=\"name\">get</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span><i> index</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the copy of the alarm event at <i>index</i> in the model. This allows the alarm data to be modified and updated either through normal component binding or in Javascript functions.</p>\n<pre class=\"cpp\">Component<span class=\"operator\">.</span>onCompleted: {\n var alarm <span class=\"operator\">=</span> alarmModel<span class=\"operator\">.</span>get(<span class=\"number\">0</span>);\n alarm<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n alarm<span class=\"operator\">.</span>save();\n}</pre>\n<p>This Javascript code returns the alarm properties from the first index of the model, updates its message and updates the alarm. Note that the alarm must be saved in order to have the changes visible. The follwoing code will not update the alarm in the model/collection:</p>\n<pre class=\"cpp\">Component<span class=\"operator\">.</span>onCompleted: {\n alarmModel<span class=\"operator\">.</span>get(<span class=\"number\">0</span>)<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n alarm<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n}</pre>\n<p><b>Warning</b>: The returned object is not guarantied to remain valid, it should not be used in property bindings.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Alarm\">Alarm</a>.</p>\n</div></div><!-- @@@get -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-alarmmodel.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/208/", "name": "AlarmModel", "description": "AlarmModel holds the list of alarms defined. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.AlarmModel", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$AlarmModel-brief -->\n<p>AlarmModel holds the list of alarms defined. <a href=\"#details\">More...</a></p>\n<!-- @@@AlarmModel -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#count-prop\">count</a></b></b> : int</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">Alarm <b><b><a href=\"#get-method\">get</a></b></b>(int <i>index</i>)</li>\n</ul>\n<!-- $$$AlarmModel-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The AlarmModel is a simple container of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a> definitions stored in the alarm collection. The data provided by the model are read only, adding, modifying or removing data is only possible through <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a> functions. Any modification on the alarms or any new alarm added to the collection will refresh all the model instances. This also means that the delegates visualizing the model elements will also be re-created.</p>\n<p>Example usage:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1\n<span class=\"type\">ListView</span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span> {}\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">100</span>)\n <span class=\"name\">delegate</span>: <span class=\"name\">Subtitled</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">subText</span>: <span class=\"name\">Qt</span>.<span class=\"name\">formatDateTime</span>(<span class=\"name\">date</span>)\n }\n}</pre>\n<p>The model defines the same roles as the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a> properties. Note that the use of <i>enabled</i> role in delegates may be ambiguous. Therefore the model defines the additional role called <i>model</i>, which represents the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a> object from the index the delegate is showing the data, so the <i>enabled</i> role can then be accessed by simply dereferencing the model i.e&#x2e; model.enabled.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">ListView</span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{}\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n }\n }\n}</pre>\n<p>The number of alarm events can be obtained from the <a href=\"#count-prop\">count</a> property. To get a specific alarm event data from the model, use the <a href=\"#get-method\">get()</a> function.</p>\n<p>As the <a href=\"#get-method\">get()</a> function returns the alarm object from the given index. Combined with the alarm functions the alarms can be updated in place.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">ListView</span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarmModel</span>\n }\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n <span class=\"name\">onCheckedChanged</span>: {\n <span class=\"keyword\">if</span> (<span class=\"name\">checked</span> <span class=\"operator\">!=</span> <span class=\"name\">model</span>.<span class=\"name\">enabled</span>) {\n var <span class=\"name\">data</span> = <span class=\"name\">alarmModel</span>.<span class=\"name\">get</span>(<span class=\"name\">index</span>);\n <span class=\"name\">data</span>.<span class=\"name\">enabled</span> <span class=\"operator\">=</span> <span class=\"name\">checked</span>;\n <span class=\"name\">data</span>.<span class=\"name\">save</span>();\n }\n }\n }\n }\n}</pre>\n<p>In this kind of &quot;in place&quot; updates using the <i>model</i> role would give the same result:</p>\n<pre class=\"qml\"><span class=\"type\">ListView</span> {\n <span class=\"name\">model</span>: <span class=\"name\">AlarmModel</span>{\n <span class=\"name\">id</span>: <span class=\"name\">alarmModel</span>\n }\n <span class=\"name\">delegate</span>: <span class=\"name\">Standard</span> {\n <span class=\"name\">text</span>: <span class=\"name\">message</span>\n <span class=\"name\">control</span>: <span class=\"name\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"name\">model</span>.<span class=\"name\">enabled</span>\n <span class=\"name\">onCheckedChanged</span>: {\n <span class=\"keyword\">if</span> (<span class=\"name\">checked</span> <span class=\"operator\">!=</span> <span class=\"name\">model</span>.<span class=\"name\">enabled</span>) {\n <span class=\"name\">model</span>.<span class=\"name\">enabled</span> <span class=\"operator\">=</span> <span class=\"name\">checked</span>;\n <span class=\"name\">model</span>.<span class=\"name\">save</span>();\n }\n }\n }\n }\n}</pre>\n<!-- @@@AlarmModel -->\n<h2>Property Documentation</h2>\n<!-- $$$count -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"count-prop\"></a><span class=\"name\">count</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The number of data entries in the model.</p>\n</div></div><!-- @@@count -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$get -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"get-method\"></a><span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a></span> AlarmModel::<span class=\"name\">get</span>(<span class=\"type\">int</span><i> index</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the copy of the alarm event at <i>index</i> in the model. This allows the alarm data to be modified and updated either through normal component binding or in Javascript functions.</p>\n<pre class=\"cpp\">Component<span class=\"operator\">.</span>onCompleted: {\n var alarm <span class=\"operator\">=</span> alarmModel<span class=\"operator\">.</span>get(<span class=\"number\">0</span>);\n alarm<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n alarm<span class=\"operator\">.</span>save();\n}</pre>\n<p>This Javascript code returns the alarm properties from the first index of the model, updates its message and updates the alarm. Note that the alarm must be saved in order to have the changes visible. The follwoing code will not update the alarm in the model/collection:</p>\n<pre class=\"cpp\">Component<span class=\"operator\">.</span>onCompleted: {\n alarmModel<span class=\"operator\">.</span>get(<span class=\"number\">0</span>)<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n alarm<span class=\"operator\">.</span>message <span class=\"operator\">+</span><span class=\"operator\">=</span> <span class=\"string\">&quot; updated&quot;</span>;\n}</pre>\n<p><b>Warning</b>: The returned object is not guarantied to remain valid, it should not be used in property bindings.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Alarm/\">Alarm</a>.</p>\n</div></div><!-- @@@get -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/209/", "name": "Argument", "description": "The Argument class specifies what type a given command line parameter should be. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Argument", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Argument-brief -->\n<p>The Argument class specifies what type a given command line parameter should be. <a href=\"#details\">More...</a></p>\n<!-- @@@Argument -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#help-prop\">help</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#name-prop\">name</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#required-prop\">required</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#valueNames-prop\">valueNames</a></b></b> : list&lt;string&gt;</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">string <b><b><a href=\"#at-method\">at</a></b></b>(int <i>i</i>)</li>\n</ul>\n<!-- $$$Argument-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>Important</b>: Argument is not used on its own but must be a child of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Arguments/\">Arguments</a>.</p>\n<p>An Argument is defined by its <a href=\"#name-prop\">name</a> and <a href=\"#valueNames-prop\">valueNames</a> properties which correspond to a command line parameter (e.g&#x2e; <i>--target</i>) and the values passed to it (e.g&#x2e; <i>--target=http://myaddress</i>).</p>\n<p>For example, the following code allows to retrieve parameters on the command line of the form <i>--target=URL</i>:</p>\n<pre class=\"qml\"><span class=\"type\">Argument</span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;target&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;address of the resource to retrieve&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">true</span>\n <span class=\"name\">valueNames</span>: [<span class=\"string\">&quot;URL&quot;</span>]\n}</pre>\n<p>To retrieve a value passed to the parameter knowing its position, use the <a href=\"#at-method\">at</a> method.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Arguments/\">Arguments</a>.</p>\n<!-- @@@Argument -->\n<h2>Property Documentation</h2>\n<!-- $$$help -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"help-prop\"></a><span class=\"name\">help</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Help displayed when launching the application with --usage.</p>\n</div></div><!-- @@@help -->\n<br/>\n<!-- $$$name -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"name-prop\"></a><span class=\"name\">name</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Name identifying the command line argument.</p>\n<p>For example 'target' corrsesponds to the <i>'--target'</i> command line argument.</p>\n</div></div><!-- @@@name -->\n<br/>\n<!-- $$$required -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"required-prop\"></a><span class=\"name\">required</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether or not this argument needs to be passed on the command line when launching the application.</p>\n</div></div><!-- @@@required -->\n<br/>\n<!-- $$$valueNames -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"valueNames-prop\"></a><span class=\"name\">valueNames</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">string</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Names given to the values of this argument. They are used when displaying the expected command line arguments of the application.</p>\n<p>Typically all capital letters (e.g&#x2e; URL).</p>\n</div></div><!-- @@@valueNames -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$at -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"at-method\"></a><span class=\"type\">string</span> Argument::<span class=\"name\">at</span>(<span class=\"type\">int</span><i> i</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the <i>i</i>th value of the argument. Values are counted from 0.</p>\n</div></div><!-- @@@at -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/523/", "name": "Argument", "description": "The Argument class specifies what type a given command line parameter should be. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Argument", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Argument-brief -->\n<p>The Argument class specifies what type a given command line parameter should be. <a href=\"#details\">More...</a></p>\n<!-- @@@Argument -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#help-prop\">help</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#name-prop\">name</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#required-prop\">required</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#valueNames-prop\">valueNames</a></b></b> : list&lt;string&gt;</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">string <b><b><a href=\"#at-method\">at</a></b></b>(int <i>i</i>)</li>\n</ul>\n<!-- $$$Argument-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>Important</b>: Argument is not used on its own but must be a child of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Arguments\">Arguments</a>.</p>\n<p>An Argument is defined by its <a href=\"#name-prop\">name</a> and <a href=\"#valueNames-prop\">valueNames</a> properties which correspond to a command line parameter (e.g&#x2e; <i>--target</i>) and the values passed to it (e.g&#x2e; <i>--target=http://myaddress</i>).</p>\n<p>For example, the following code allows to retrieve parameters on the command line of the form <i>--target=URL</i>:</p>\n<pre class=\"qml\"><span class=\"type\">Argument</span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;target&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;address of the resource to retrieve&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">true</span>\n <span class=\"name\">valueNames</span>: [<span class=\"string\">&quot;URL&quot;</span>]\n}</pre>\n<p>To retrieve a value passed to the parameter knowing its position, use the <a href=\"#at-method\">at</a> method.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Arguments\">Arguments</a>.</p>\n<!-- @@@Argument -->\n<h2>Property Documentation</h2>\n<!-- $$$help -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"help-prop\"></a><span class=\"name\">help</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Help displayed when launching the application with --usage.</p>\n</div></div><!-- @@@help -->\n<br/>\n<!-- $$$name -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"name-prop\"></a><span class=\"name\">name</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Name identifying the command line argument.</p>\n<p>For example 'target' corrsesponds to the <i>'--target'</i> command line argument.</p>\n</div></div><!-- @@@name -->\n<br/>\n<!-- $$$required -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"required-prop\"></a><span class=\"name\">required</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether or not this argument needs to be passed on the command line when launching the application.</p>\n</div></div><!-- @@@required -->\n<br/>\n<!-- $$$valueNames -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"valueNames-prop\"></a><span class=\"name\">valueNames</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Names given to the values of this argument. They are used when displaying the expected command line arguments of the application.</p>\n<p>Typically all capital letters (e.g&#x2e; URL).</p>\n</div></div><!-- @@@valueNames -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$at -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"at-method\"></a><span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span> Argument::<span class=\"name\">at</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span><i> i</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the <i>i</i>th value of the argument. Values are counted from 0.</p>\n</div></div><!-- @@@at -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-argument.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/524/", "name": "Arguments", "description": "The Arguments class provides a way to declare what command line parameters are expected by the application. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Arguments", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Arguments-brief -->\n<p>The Arguments class provides a way to declare what command line parameters are expected by the application. <a href=\"#details\">More...</a></p>\n<!-- @@@Arguments -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#arguments-prop\">arguments</a></b></b> : list&lt;Argument&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#defaultArgument-prop\">defaultArgument</a></b></b> : Argument</li>\n<li class=\"fn\"><b><b><a href=\"#error-prop\">error</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#errorMessage-prop\">errorMessage</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#values-prop\">values</a></b></b> : Object</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">void <b><b><a href=\"#printUsage-method\">printUsage</a></b></b>()</li>\n<li class=\"fn\">void <b><b><a href=\"#quitWithError-method\">quitWithError</a></b></b>(string <i>errorMessage</i>)</li>\n</ul>\n<!-- $$$Arguments-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Example of use:</p>\n<pre class=\"qml\"><span class=\"type\">Arguments</span> {\n <span class=\"name\">id</span>: <span class=\"name\">args</span>\n <span class=\"name\">defaultArgument</span>.help: <span class=\"string\">&quot;Expects URL of the media to play.&quot;</span>\n <span class=\"name\">defaultArgument</span>.valueNames: [<span class=\"string\">&quot;URL&quot;</span>]\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Argument\">Argument</a></span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;fullscreen&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;whether or not the media will be played fullscreen&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">false</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Argument\">Argument</a></span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;volume&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;level to which to set the volume&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">false</span>\n <span class=\"name\">valueNames</span>: [<span class=\"string\">&quot;VOLUME_LEVEL&quot;</span>]\n }\n}</pre>\n<p>The code above ensures that at least one argument is passed on the command line which will then be available in QML via the <a href=\"#defaultArgument-prop\">defaultArgument</a> property. Optionally two other arguments can be passed:</p>\n<p><i>--fullscreen</i> that will be exposed as a boolean property: <a href=\"#values-prop\">values</a>.fullscreen</p>\n<p><i>--volume</i> that will be exposed as a string property: <a href=\"#values-prop\">values</a>.volume</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;volume = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">values</span>.<span class=\"name\">volume</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;fullscreen = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">values</span>.<span class=\"name\">fullscreen</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;URL = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">defaultArgument</span>.<span class=\"name\">at</span>(<span class=\"number\">0</span>)\n }\n}</pre>\n<p>If the application is launched with the incorrect arguments or with the <i>--usage</i> argument an help will be outputted on the command line and the application will exit:</p>\n<pre class=\"cpp\">Usage: application <span class=\"operator\">[</span><span class=\"operator\">-</span><span class=\"operator\">-</span>fullscreen<span class=\"operator\">]</span> <span class=\"operator\">[</span><span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span>VOLUME_LEVEL<span class=\"operator\">]</span> URL\nOptions:\n<span class=\"operator\">-</span><span class=\"operator\">-</span>fullscreen whether <span class=\"keyword\">or</span> <span class=\"keyword\">not</span> the media will be played fullscreen\n<span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span>VOLUME_LEVE level to which to set the volume\nExpects URL of the media to play<span class=\"operator\">.</span></pre>\n<p><b>See also </b><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Argument\">Argument</a>.</p>\n<!-- @@@Arguments -->\n<h2>Property Documentation</h2>\n<!-- $$$arguments -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"arguments-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"qmldefault\">default</span><span class=\"name\">arguments</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\">Argument</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>List of command line arguments that are expected by the application.</p>\n<p>See detailed description above for an example on how to use it.</p>\n</div></div><!-- @@@arguments -->\n<br/>\n<!-- $$$defaultArgument -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"defaultArgument-prop\"></a><span class=\"name\">defaultArgument</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Argument\">Argument</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The default argument corresponds to the values passed on the command line without any name.</p>\n<p>For example in:</p>\n<pre class=\"cpp\"><span class=\"operator\">.</span><span class=\"operator\">/</span>application <span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span><span class=\"number\">42</span> http:<span class=\"comment\">//myaddress</span></pre>\n<p><i>http://myaddress</i> is the first value of the default argument.</p>\n</div></div><!-- @@@defaultArgument -->\n<br/>\n<!-- $$$error -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"error-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">error</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether or not the command line arguments passed to the application correspond to the expected arguments.</p>\n<p>Also set when calling <a href=\"#quitWithError-method\">quitWithError</a></p>\n</div></div><!-- @@@error -->\n<br/>\n<!-- $$$errorMessage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"errorMessage-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">errorMessage</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Error message describing how the command line arguments passed to the application failed to correspond to the expected arguments.</p>\n<p>Also set when calling <a href=\"#quitWithError-method\">quitWithError</a></p>\n</div></div><!-- @@@errorMessage -->\n<br/>\n<!-- $$$values -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"values-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">values</span> : <span class=\"type\">Object</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Object of which properties have the values of the command line arguments.</p>\n</div></div><!-- @@@values -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$printUsage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"printUsage-method\"></a><span class=\"type\">void</span> Arguments::<span class=\"name\">printUsage</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Outputs help to the console on how to pass arguments to the application.</p>\n</div></div><!-- @@@printUsage -->\n<br/>\n<!-- $$$quitWithError -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"quitWithError-method\"></a><span class=\"type\">void</span> Arguments::<span class=\"name\">quitWithError</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span><i> errorMessage</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Exits the application outputting <i>errorMessage</i> to the console.</p>\n</div></div><!-- @@@quitWithError -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-arguments.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/210/", "name": "Arguments", "description": "The Arguments class provides a way to declare what command line parameters are expected by the application. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Arguments", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Arguments-brief -->\n<p>The Arguments class provides a way to declare what command line parameters are expected by the application. <a href=\"#details\">More...</a></p>\n<!-- @@@Arguments -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#arguments-prop\">arguments</a></b></b> : list&lt;Argument&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#defaultArgument-prop\">defaultArgument</a></b></b> : Argument</li>\n<li class=\"fn\"><b><b><a href=\"#error-prop\">error</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#errorMessage-prop\">errorMessage</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#values-prop\">values</a></b></b> : Object</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">void <b><b><a href=\"#printUsage-method\">printUsage</a></b></b>()</li>\n<li class=\"fn\">void <b><b><a href=\"#quitWithError-method\">quitWithError</a></b></b>(string <i>errorMessage</i>)</li>\n</ul>\n<!-- $$$Arguments-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Example of use:</p>\n<pre class=\"qml\"><span class=\"type\">Arguments</span> {\n <span class=\"name\">id</span>: <span class=\"name\">args</span>\n <span class=\"name\">defaultArgument</span>.help: <span class=\"string\">&quot;Expects URL of the media to play.&quot;</span>\n <span class=\"name\">defaultArgument</span>.valueNames: [<span class=\"string\">&quot;URL&quot;</span>]\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">Argument</a></span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;fullscreen&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;whether or not the media will be played fullscreen&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">false</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">Argument</a></span> {\n <span class=\"name\">name</span>: <span class=\"string\">&quot;volume&quot;</span>\n <span class=\"name\">help</span>: <span class=\"string\">&quot;level to which to set the volume&quot;</span>\n <span class=\"name\">required</span>: <span class=\"number\">false</span>\n <span class=\"name\">valueNames</span>: [<span class=\"string\">&quot;VOLUME_LEVEL&quot;</span>]\n }\n}</pre>\n<p>The code above ensures that at least one argument is passed on the command line which will then be available in QML via the <a href=\"#defaultArgument-prop\">defaultArgument</a> property. Optionally two other arguments can be passed:</p>\n<p><i>--fullscreen</i> that will be exposed as a boolean property: <a href=\"#values-prop\">values</a>.fullscreen</p>\n<p><i>--volume</i> that will be exposed as a string property: <a href=\"#values-prop\">values</a>.volume</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;volume = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">values</span>.<span class=\"name\">volume</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;fullscreen = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">values</span>.<span class=\"name\">fullscreen</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;URL = &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">args</span>.<span class=\"name\">defaultArgument</span>.<span class=\"name\">at</span>(<span class=\"number\">0</span>)\n }\n}</pre>\n<p>If the application is launched with the incorrect arguments or with the <i>--usage</i> argument an help will be outputted on the command line and the application will exit:</p>\n<pre class=\"cpp\">Usage: application <span class=\"operator\">[</span><span class=\"operator\">-</span><span class=\"operator\">-</span>fullscreen<span class=\"operator\">]</span> <span class=\"operator\">[</span><span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span>VOLUME_LEVEL<span class=\"operator\">]</span> URL\nOptions:\n<span class=\"operator\">-</span><span class=\"operator\">-</span>fullscreen whether <span class=\"keyword\">or</span> <span class=\"keyword\">not</span> the media will be played fullscreen\n<span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span>VOLUME_LEVE level to which to set the volume\nExpects URL of the media to play<span class=\"operator\">.</span></pre>\n<p><b>See also </b><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">Argument</a>.</p>\n<!-- @@@Arguments -->\n<h2>Property Documentation</h2>\n<!-- $$$arguments -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"arguments-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"qmldefault\">default</span><span class=\"name\">arguments</span> : <span class=\"type\">list</span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">Argument</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>List of command line <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">arguments</a> that are expected by the application.</p>\n<p>See detailed description above for an example on how to use it.</p>\n</div></div><!-- @@@arguments -->\n<br/>\n<!-- $$$defaultArgument -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"defaultArgument-prop\"></a><span class=\"name\">defaultArgument</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Argument/\">Argument</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The default argument corresponds to the values passed on the command line without any name.</p>\n<p>For example in:</p>\n<pre class=\"cpp\"><span class=\"operator\">.</span><span class=\"operator\">/</span>application <span class=\"operator\">-</span><span class=\"operator\">-</span>volume<span class=\"operator\">=</span><span class=\"number\">42</span> http:<span class=\"comment\">//myaddress</span></pre>\n<p><i>http://myaddress</i> is the first value of the default argument.</p>\n</div></div><!-- @@@defaultArgument -->\n<br/>\n<!-- $$$error -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"error-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">error</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether or not the command line arguments passed to the application correspond to the expected arguments.</p>\n<p>Also set when calling <a href=\"#quitWithError-method\">quitWithError</a></p>\n</div></div><!-- @@@error -->\n<br/>\n<!-- $$$errorMessage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"errorMessage-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">errorMessage</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Error message describing how the command line arguments passed to the application failed to correspond to the expected arguments.</p>\n<p>Also set when calling <a href=\"#quitWithError-method\">quitWithError</a></p>\n</div></div><!-- @@@errorMessage -->\n<br/>\n<!-- $$$values -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"values-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">values</span> : <span class=\"type\">Object</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Object of which properties have the values of the command line arguments.</p>\n</div></div><!-- @@@values -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$printUsage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"printUsage-method\"></a><span class=\"type\">void</span> Arguments::<span class=\"name\">printUsage</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Outputs help to the console on how to pass arguments to the application.</p>\n</div></div><!-- @@@printUsage -->\n<br/>\n<!-- $$$quitWithError -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"quitWithError-method\"></a><span class=\"type\">void</span> Arguments::<span class=\"name\">quitWithError</span>(<span class=\"type\">string</span><i> errorMessage</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Exits the application outputting <i>errorMessage</i> to the console.</p>\n</div></div><!-- @@@quitWithError -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/156/", "name": "Button", "description": "Standard Ubuntu button. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Button", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Button-brief -->\n<p>Standard Ubuntu button. <a href=\"#details\">More...</a></p>\n<!-- @@@Button -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.AbstractButton/\">AbstractButton</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#gradient-prop\">gradient</a></b></b> : Gradient</li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconPosition-prop\">iconPosition</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<!-- $$$Button-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/buttons\">See also the Design Guidelines on Buttons</a>.</p>\n<p>Examples:</p>\n<pre class=\"qml\"><span class=\"type\">Column</span> {\n <span class=\"type\">Button</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Send&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked text-only Button&quot;</span>)\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;icon.png&quot;</span>\n <span class=\"name\">gradient</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">greyGradient</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked icon-only Button&quot;</span>)\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;icon.png&quot;</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Icon on left&quot;</span>\n <span class=\"name\">iconPosition</span>: <span class=\"string\">&quot;left&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked text and icon Button&quot;</span>)\n }\n}</pre>\n<p>An <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> can be used to specify <b>clicked</b>, iconSource and text. Example:</p>\n<pre class=\"qml\"> <span class=\"type\">Item</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">action1</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click me&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;action!&quot;</span>)\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;icon.png&quot;</span>\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">action</span>: <span class=\"name\">action1</span>\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">warmGrey</span>\n }\n}</pre>\n<!-- @@@Button -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> associated with this <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\">color</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The background color of the button.</p>\n<p><b>See also </b><a href=\"#gradient-prop\">gradient</a>.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$gradient -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"gradient-prop\"></a><span class=\"name\">gradient</span> : <span class=\"type\">Gradient</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The gradient used to fill the background of the button.</p>\n<p>Standard Ubuntu gradients are defined in <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.UbuntuColors/\">UbuntuColors</a>.</p>\n<p>If both a gradient and a color are specified, the gradient will be used.</p>\n<p><b>See also </b><a href=\"#color-prop\">color</a>.</p>\n</div></div><!-- @@@gradient -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconPosition-prop\"></a><span class=\"name\">iconPosition</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the icon relative to the text. Options are &quot;left&quot; and &quot;right&quot;. The default value is &quot;left&quot;.</p>\n<p>If only text or only an icon is defined, this property is ignored and the text or icon is centered horizontally and vertically in the button.</p>\n<p>Currently this is a string value. We are waiting for support for enums: https://bugreports.qt-project.org/browse/QTBUG-14861</p>\n</div></div><!-- @@@iconPosition -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.iconSource.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/464/", "name": "Button", "description": "Standard Ubuntu button. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Button", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Button-brief -->\n<p>Standard Ubuntu button. <a href=\"#details\">More...</a></p>\n<!-- @@@Button -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.AbstractButton\">AbstractButton</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#gradient-prop\">gradient</a></b></b> : Gradient</li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconPosition-prop\">iconPosition</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<!-- $$$Button-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/buttons\">See also the Design Guidelines on Buttons</a>.</p>\n<p>Examples:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Column\">Column</a></span> {\n <span class=\"type\">Button</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Send&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked text-only Button&quot;</span>)\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n <span class=\"name\">gradient</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">greyGradient</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked icon-only Button&quot;</span>)\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Icon on left&quot;</span>\n <span class=\"name\">iconPosition</span>: <span class=\"string\">&quot;left&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;clicked text and icon Button&quot;</span>)\n }\n}</pre>\n<p>An <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> can be used to specify <b>clicked</b>, iconSource and text. Example:</p>\n<pre class=\"qml\"> <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">action1</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click me&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;action!&quot;</span>)\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n }\n <span class=\"type\">Button</span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">action</span>: <span class=\"name\">action1</span>\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">warmGrey</span>\n }\n}</pre>\n<!-- @@@Button -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> associated with this <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qml-color.html\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The background color of the button.</p>\n<p><b>See also </b><a href=\"#gradient-prop\">gradient</a>.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$gradient -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"gradient-prop\"></a><span class=\"name\">gradient</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Gradient\">Gradient</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The gradient used to fill the background of the button.</p>\n<p>Standard Ubuntu gradients are defined in <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.UbuntuColors\">UbuntuColors</a>.</p>\n<p>If both a gradient and a color are specified, the gradient will be used.</p>\n<p><b>See also </b><a href=\"#color-prop\">color</a>.</p>\n</div></div><!-- @@@gradient -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the actionItem in the ubuntu-mobile icon theme. Default value: action.iconName.</p>\n<p>If both <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconPosition-prop\"></a><span class=\"name\">iconPosition</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the icon relative to the text. Options are &quot;left&quot; and &quot;right&quot;. The default value is &quot;left&quot;.</p>\n<p>If only text or only an icon is defined, this property is ignored and the text or icon is centered horizontally and vertically in the button.</p>\n<p>Currently this is a string value. We are waiting for support for enums: https://bugreports.qt-project.org/browse/QTBUG-14861</p>\n</div></div><!-- @@@iconPosition -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the actionItem. Default value: action.iconSource.</p>\n<p>If both iconSource and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> are defined, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> will be ignored.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the actionItem. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-button.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/158/", "name": "CheckBox", "description": "CheckBox is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Switch/\">Switch</a>, the only difference is the graphical style. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.CheckBox", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$CheckBox-brief -->\n<p>CheckBox is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Switch/\">Switch</a>, the only difference is the graphical style. <a href=\"#details\">More...</a></p>\n<!-- @@@CheckBox -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.AbstractButton/\">AbstractButton</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Switch/\">Switch</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#checked-prop\">checked</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<!-- $$$CheckBox-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/toggles\">See also the Design Guidelines on Toggles</a>.</p>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">CheckBox</span> {\n <span class=\"name\">checked</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@CheckBox -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a> associated with this <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$checked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"checked-prop\"></a><span class=\"name\">checked</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies whether the checkbox is checked or not. By default the property is set to false.</p>\n</div></div><!-- @@@checked -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.iconSource.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">actionItem</a>. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/466/", "name": "CheckBox", "description": "CheckBox is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Switch\">Switch</a>, the only difference is the graphical style. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.CheckBox", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$CheckBox-brief -->\n<p>CheckBox is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Switch\">Switch</a>, the only difference is the graphical style. <a href=\"#details\">More...</a></p>\n<!-- @@@CheckBox -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.AbstractButton\">AbstractButton</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Switch\">Switch</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#checked-prop\">checked</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#hovered-prop\">hovered</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n</ul>\n<!-- $$$CheckBox-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/toggles\">See also the Design Guidelines on Toggles</a>.</p>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">CheckBox</span> {\n <span class=\"name\">checked</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@CheckBox -->\n<h2>Property Documentation</h2>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> associated with this <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$checked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"checked-prop\"></a><span class=\"name\">checked</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies whether the checkbox is checked or not. By default the property is set to false.</p>\n</div></div><!-- @@@checked -->\n<br/>\n<!-- $$$hovered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hovered-prop\"></a><span class=\"name\">hovered</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the mouse cursor hovers over the button's mouse area.</p>\n</div></div><!-- @@@hovered -->\n<br/>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the actionItem in the ubuntu-mobile icon theme. Default value: action.iconName.</p>\n<p>If both <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the actionItem. Default value: action.iconSource.</p>\n<p>If both iconSource and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> are defined, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> will be ignored.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>True if the user presses a mouse button in the button's mouse area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the actionItem. Default value: action.text</p>\n</div></div><!-- @@@text -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-checkbox.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/205/", "name": "Clipboard", "description": "This is a singleton type providing access to the system clipboard. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Clipboard", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Clipboard-brief -->\n<p>This is a singleton type providing access to the system clipboard. <a href=\"#details\">More...</a></p>\n<!-- @@@Clipboard -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#data-prop\">data</a></b></b> : MimeData</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#dataChanged-signal\">dataChanged</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">MimeData <b><b><a href=\"#newData-method\">newData</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#clear-method\">clear</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#push-method\">push</a></b></b>(var <i>data</i>)</li>\n</ul>\n<!-- $$$Clipboard-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Clipboard data can be retrieved through data property, which returns an object of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> type. The actual content of the clipboard can be accessed through this object. Data can be pushed to the clipboard using <a href=\"#push-method\">push()</a> function.</p>\n<p>The clipboard data cannot be modified through the type returned by the data property, for this a new instance of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> type must be used. This instance can be either a standalone MimeDala component or an object created using <a href=\"#newData-method\">newData()</a> function. Remember that standalone <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> types duplicate the clipboard data which may cause extensive memory use.</p>\n<p>Examples of use:</p>\n<p>1. Using standard MimeType component - the following example copies the selected text from the text area into the clipboard pushing also a color</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">mimeData</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;green&quot;</span>\n <span class=\"name\">text</span>: <span class=\"name\">editor</span>.<span class=\"name\">text</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">mimeData</span>)\n }\n}</pre>\n<p>2. Pushing data straight to clipboard</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: {\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">editor</span>.<span class=\"name\">text</span>);\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>([<span class=\"string\">&quot;application/x-color&quot;</span>, <span class=\"string\">&quot;green&quot;</span>]);\n }\n }\n}</pre>\n<p>3. Pushing data using <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> object</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: {\n var <span class=\"name\">mimeData</span> = <span class=\"name\">Clipboard</span>.<span class=\"name\">newData</span>();\n <span class=\"name\">mimeData</span>.<span class=\"name\">text</span> <span class=\"operator\">=</span> <span class=\"name\">editor</span>.<span class=\"name\">text</span>;\n <span class=\"name\">mimeData</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"string\">&quot;green&quot;</span>;\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">mimeData</span>);\n }\n }\n}</pre>\n<!-- @@@Clipboard -->\n<h2>Property Documentation</h2>\n<!-- $$$data -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"data-prop\"></a><span class=\"name\">data</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides access to the Clipboard's current data.</p>\n</div></div><!-- @@@data -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$dataChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"dataChanged-signal\"></a>Clipboard::<span class=\"name\">dataChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal is triggered when clipboard content gets changed.</p>\n</div></div><!-- @@@dataChanged -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$newData -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"newData-method\"></a><span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a></span> Clipboard::<span class=\"name\">newData</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function returns a new <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> object that can be used in Java script code to push pultiple MIME types at the same time.</p>\n</div></div><!-- @@@newData -->\n<br/>\n<!-- $$$clear -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clear-method\"></a>Clipboard::<span class=\"name\">clear</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function clears the clipboard content.</p>\n</div></div><!-- @@@clear -->\n<br/>\n<!-- $$$push -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"push-method\"></a>Clipboard::<span class=\"name\">push</span>(<span class=\"type\">var</span><i> data</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function copies data provided as parameter to the clipboard. The parameter can be a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> instance or object created using <a href=\"#newData-method\">newData()</a> beside the ones listed at <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/#data-prop\">MimeData::data</a>.</p>\n<p>When <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MimeData/\">MimeData</a> instance or object is given, the entire object content will be pushed to the clipboard.</p>\n</div></div><!-- @@@push -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/518/", "name": "Clipboard", "description": "This is a singleton type providing access to the system clipboard. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Clipboard", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Clipboard-brief -->\n<p>This is a singleton type providing access to the system clipboard. <a href=\"#details\">More...</a></p>\n<!-- @@@Clipboard -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#data-prop\">data</a></b></b> : MimeData</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#dataChanged-signal\">dataChanged</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">MimeData <b><b><a href=\"#newData-method\">newData</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#clear-method\">clear</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#push-method\">push</a></b></b>(var <i>data</i>)</li>\n</ul>\n<!-- $$$Clipboard-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Clipboard data can be retrieved through data property, which returns an object of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> type. The actual content of the clipboard can be accessed through this object. Data can be pushed to the clipboard using <a href=\"#push-method\">push()</a> function.</p>\n<p>The clipboard data cannot be modified through the type returned by the data property, for this a new instance of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> type must be used. This instance can be either a standalone MimeDala component or an object created using <a href=\"#newData-method\">newData()</a> function. Remember that standalone <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> types duplicate the clipboard data which may cause extensive memory use.</p>\n<p>Examples of use:</p>\n<p>1. Using standard MimeType component - the following example copies the selected text from the text area into the clipboard pushing also a color</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">mimeData</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;green&quot;</span>\n <span class=\"name\">text</span>: <span class=\"name\">editor</span>.<span class=\"name\">text</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">mimeData</span>)\n }\n}</pre>\n<p>2. Pushing data straight to clipboard</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: {\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">editor</span>.<span class=\"name\">text</span>);\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>([<span class=\"string\">&quot;application/x-color&quot;</span>, <span class=\"string\">&quot;green&quot;</span>]);\n }\n }\n}</pre>\n<p>3. Pushing data using <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> object</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">editor</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Copy&quot;</span>\n <span class=\"name\">onClicked</span>: {\n var <span class=\"name\">mimeData</span> = <span class=\"name\">Clipboard</span>.<span class=\"name\">newData</span>();\n <span class=\"name\">mimeData</span>.<span class=\"name\">text</span> <span class=\"operator\">=</span> <span class=\"name\">editor</span>.<span class=\"name\">text</span>;\n <span class=\"name\">mimeData</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"string\">&quot;green&quot;</span>;\n <span class=\"name\">Clipboard</span>.<span class=\"name\">push</span>(<span class=\"name\">mimeData</span>);\n }\n }\n}</pre>\n<!-- @@@Clipboard -->\n<h2>Property Documentation</h2>\n<!-- $$$data -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"data-prop\"></a><span class=\"name\">data</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides access to the Clipboard's current data.</p>\n</div></div><!-- @@@data -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$dataChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"dataChanged-signal\"></a>Clipboard::<span class=\"name\">dataChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal is triggered when clipboard content gets changed.</p>\n</div></div><!-- @@@dataChanged -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$newData -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"newData-method\"></a><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a></span> Clipboard::<span class=\"name\">newData</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function returns a new <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> object that can be used in Java script code to push pultiple MIME types at the same time.</p>\n</div></div><!-- @@@newData -->\n<br/>\n<!-- $$$clear -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clear-method\"></a>Clipboard::<span class=\"name\">clear</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>The function clears the clipboard content.</p>\n</div></div><!-- @@@clear -->\n<br/>\n<!-- $$$push -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"push-method\"></a>Clipboard::<span class=\"name\">push</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span><i> data</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function copies data provided as parameter to the clipboard. The parameter can be a MimeData instance or object created using <a href=\"#newData-method\">newData()</a> beside the ones listed at MimeData::data.</p>\n<p>When <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MimeData\">MimeData</a> instance or object is given, the entire object content will be pushed to the clipboard.</p>\n</div></div><!-- @@@push -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-clipboard.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/468/", "name": "CrossFadeImage", "description": "An Image like component which smoothly fades when its source is updated. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.CrossFadeImage", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$CrossFadeImage-brief -->\n<p>An Image like component which smoothly fades when its source is updated. <a href=\"#details\">More...</a></p>\n<!-- @@@CrossFadeImage -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#fadeDuration-prop\">fadeDuration</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#fillMode-prop\">fillMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#running-prop\">running</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#source-prop\">source</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#sourceSize-prop\">sourceSize</a></b></b> : size</li>\n<li class=\"fn\"><b><b><a href=\"#status-prop\">status</a></b></b> : enumeration</li>\n</ul>\n<!-- $$$CrossFadeImage-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">CrossFadeImage</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">100</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">75</span>)\n <span class=\"name\">source</span>: <span class=\"string\">&quot;http://design.ubuntu.com/wp-content/uploads/ubuntu-logo14.png&quot;</span>\n <span class=\"name\">fadeDuration</span>: <span class=\"number\">1000</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">parent</span>.<span class=\"name\">source</span> <span class=\"operator\">=</span> <span class=\"string\">&quot;http://design.ubuntu.com/wp-content/uploads/canonical-logo1.png&quot;</span>\n }\n}</pre>\n<!-- @@@CrossFadeImage -->\n<h2>Property Documentation</h2>\n<!-- $$$fadeDuration -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"fadeDuration-prop\"></a><span class=\"name\">fadeDuration</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The time over which to fade between images. Defaults to <tt>UbuntuAnimation.FastDuration</tt>.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.UbuntuAnimation\">UbuntuAnimation</a>.</p>\n</div></div><!-- @@@fadeDuration -->\n<br/>\n<!-- $$$fillMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"fillMode-prop\"></a><span class=\"name\">fillMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Defaults to <tt>Image.PreserveAspectFit</tt>.</p>\n<ul>\n<li>Image.Stretch - the image is scaled to fit</li>\n<li>Image.PreserveAspectFit - the image is scaled uniformly to fit without cropping</li>\n<li>Image.PreserveAspectCrop - the image is scaled uniformly to fill, cropping if necessary</li>\n<li>Image.Tile - the image is duplicated horizontally and vertically</li>\n<li>Image.TileVertically - the image is stretched horizontally and tiled vertically</li>\n<li>Image.TileHorizontally - the image is stretched vertically and tiled horizontally</li>\n<li>Image.Pad - the image is not transformed</li>\n</ul>\n</div></div><!-- @@@fillMode -->\n<br/>\n<!-- $$$running -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"running-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">running</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the animation is running</p>\n</div></div><!-- @@@running -->\n<br/>\n<!-- $$$source -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"source-prop\"></a><span class=\"name\">source</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image being displayed. Can be a URL to any image format supported by Qt.</p>\n</div></div><!-- @@@source -->\n<br/>\n<!-- $$$sourceSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"sourceSize-prop\"></a><span class=\"name\">sourceSize</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-size.html\">size</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The actual width and height of the loaded image This property holds the actual width and height of the loaded image.</p>\n<p>Unlike the width and height properties, which scale the painting of the image, this property sets the actual number of pixels stored for the loaded image so that large images do not use more memory than necessary.</p>\n<p>Note: Changing this property dynamically causes the image source to be reloaded, potentially even from the network, if it is not in the disk cache.</p>\n</div></div><!-- @@@sourceSize -->\n<br/>\n<!-- $$$status -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"status-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">status</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds the status of image loading. It can be one of:</p>\n<ul>\n<li>Image.Null - no image has been set</li>\n<li>Image.Ready - the image has been loaded</li>\n<li>Image.Loading - the image is currently being loaded</li>\n<li>Image.Error - an error occurred while loading the image</li>\n</ul>\n</div></div><!-- @@@status -->\n<br/>\n</div></div>\n", "source_file": "qml-crossfadeimage.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/525/", "name": "FontUtils", "description": "FontUtils is a <a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qqmlcontext.html#details\">context property</a>, which provides utility functions for font manipulations. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.FontUtils", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$FontUtils-brief -->\n<p>FontUtils is a <a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qqmlcontext.html#details\">context property</a>, which provides utility functions for font manipulations. <a href=\"#details\">More...</a></p>\n<!-- @@@FontUtils -->\n<ul>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">real <b><b><a href=\"#modularScale-method\">modularScale</a></b></b>(string <i>size</i>)</li>\n<li class=\"fn\">real <b><b><a href=\"#sizeToPixels-method\">sizeToPixels</a></b></b>(string <i>size</i>)</li>\n</ul>\n<!-- $$$FontUtils-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>FontUtils cannot be instantiated and it is already available as a context property, i.e&#x2e; 'FontUtils' is an instance that can be used from anywhere in the code.</p>\n<p>Example of a Label implementation which uses the default base scale for the font size:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Text\">Text</a></span> {\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span> <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;medium&quot;</span>\n <span class=\"name\">font</span>.pixelSize: <span class=\"name\">FontUtils</span>.<span class=\"name\">sizeToPixels</span>(<span class=\"name\">fontSize</span>)\n}</pre>\n<p>Another example of a custom text input component exposing a fontSize property and a base font unit size to scale its font:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span> <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;small&quot;</span>\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span> <span class=\"name\">baseFontUnits</span>: <span class=\"name\">units</span>.<span class=\"name\">dp</span>(<span class=\"number\">20</span>)\n <span class=\"name\">font</span>.pixelSize: <span class=\"name\">FontUtils</span>.<span class=\"name\">modularScale</span>(<span class=\"name\">fontSize</span>) <span class=\"operator\">*</span> <span class=\"name\">units</span>.<span class=\"name\">dp</span>(<span class=\"name\">baseFontUnits</span>)\n}</pre>\n<!-- @@@FontUtils -->\n<h2>Method Documentation</h2>\n<!-- $$$modularScale -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"modularScale-method\"></a><span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span> FontUtils::<span class=\"name\">modularScale</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span><i> size</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function returns the number interpretation of a given font scale. The scale can have one of the following values:</p>\n<ul>\n<li><b>xx-small</b></li>\n<li><b>x-small</b></li>\n<li><b>small</b></li>\n<li><b>medium</b></li>\n<li><b>large</b></li>\n<li><b>x-large</b></li>\n</ul>\n</div></div><!-- @@@modularScale -->\n<br/>\n<!-- $$$sizeToPixels -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"sizeToPixels-method\"></a><span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span> FontUtils::<span class=\"name\">sizeToPixels</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span><i> size</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function calculates the pixel size of a given scale. The size scale can be one of the strings specified at <a href=\"#modularScale-method\">modularScale</a> function. On failure returns 0.</p>\n</div></div><!-- @@@sizeToPixels -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-fontutils.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/211/", "name": "FontUtils", "description": "FontUtils is a <a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qqmlcontext.html#details\">context property</a>, which provides utility functions for font manipulations. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.FontUtils", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$FontUtils-brief -->\n<p>FontUtils is a <a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qqmlcontext.html#details\">context property</a>, which provides utility functions for font manipulations. <a href=\"#details\">More...</a></p>\n<!-- @@@FontUtils -->\n<ul>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\">real <b><b><a href=\"#modularScale-method\">modularScale</a></b></b>(string <i>size</i>)</li>\n<li class=\"fn\">real <b><b><a href=\"#sizeToPixels-method\">sizeToPixels</a></b></b>(string <i>size</i>)</li>\n</ul>\n<!-- $$$FontUtils-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>FontUtils cannot be instantiated and it is already available as a context property, i.e&#x2e; 'FontUtils' is an instance that can be used from anywhere in the code.</p>\n<p>Example of a Label implementation which uses the default base scale for the font size:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">Text</span> {\n property <span class=\"type\">string</span> <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;medium&quot;</span>\n <span class=\"name\">font</span>.pixelSize: <span class=\"name\">FontUtils</span>.<span class=\"name\">sizeToPixels</span>(<span class=\"name\">fontSize</span>)\n}</pre>\n<p>Another example of a custom text input component exposing a fontSize property and a base font unit size to scale its font:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">TextInput</span> {\n property <span class=\"type\">string</span> <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;small&quot;</span>\n property <span class=\"type\">int</span> <span class=\"name\">baseFontUnits</span>: <span class=\"name\">units</span>.<span class=\"name\">dp</span>(<span class=\"number\">20</span>)\n <span class=\"name\">font</span>.pixelSize: <span class=\"name\">FontUtils</span>.<span class=\"name\">modularScale</span>(<span class=\"name\">fontSize</span>) <span class=\"operator\">*</span> <span class=\"name\">units</span>.<span class=\"name\">dp</span>(<span class=\"name\">baseFontUnits</span>)\n}</pre>\n<!-- @@@FontUtils -->\n<h2>Method Documentation</h2>\n<!-- $$$modularScale -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"modularScale-method\"></a><span class=\"type\">real</span> FontUtils::<span class=\"name\">modularScale</span>(<span class=\"type\">string</span><i> size</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function returns the number interpretation of a given font scale. The scale can have one of the following values:</p>\n<ul>\n<li><b>xx-small</b></li>\n<li><b>x-small</b></li>\n<li><b>small</b></li>\n<li><b>medium</b></li>\n<li><b>large</b></li>\n<li><b>x-large</b></li>\n</ul>\n</div></div><!-- @@@modularScale -->\n<br/>\n<!-- $$$sizeToPixels -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"sizeToPixels-method\"></a><span class=\"type\">real</span> FontUtils::<span class=\"name\">sizeToPixels</span>(<span class=\"type\">string</span><i> size</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function calculates the pixel size of a given scale. The size scale can be one of the strings specified at <a href=\"#modularScale-method\">modularScale</a> function. On failure returns 0.</p>\n</div></div><!-- @@@sizeToPixels -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/166/", "name": "Icon", "description": "The Icon component displays an icon from the icon theme. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Icon", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Icon-brief -->\n<p>The Icon component displays an icon from the icon theme. <a href=\"#details\">More...</a></p>\n<!-- @@@Icon -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#keyColor-prop\">keyColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#name-prop\">name</a></b></b> : string</li>\n</ul>\n<!-- $$$Icon-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The icon theme contains a set of standard icons referred to by their name. Using icons whenever possible enhances consistency accross applications. Each icon has a name and can have different visual representations depending on the size requested.</p>\n<p>Icons can also be colorized. Setting the <a href=\"#color-prop\">color</a> property will make all pixels with the <a href=\"#keyColor-prop\">keyColor</a> (by default #808080) colored.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Icon</span> {\n <span class=\"name\">width</span>: <span class=\"number\">64</span>\n <span class=\"name\">height</span>: <span class=\"number\">64</span>\n <span class=\"name\">name</span>: <span class=\"string\">&quot;search&quot;</span>\n}</pre>\n<p>Example of colorization:</p>\n<pre class=\"qml\"><span class=\"type\">Icon</span> {\n <span class=\"name\">width</span>: <span class=\"number\">64</span>\n <span class=\"name\">height</span>: <span class=\"number\">64</span>\n <span class=\"name\">name</span>: <span class=\"string\">&quot;search&quot;</span>\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">warmGrey</span>\n}</pre>\n<p>Icon themes are created following the <a href=\"http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html\">Freedesktop Icon Theme Specification</a>.</p>\n<!-- @@@Icon -->\n<h2>Property Documentation</h2>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The color that all pixels that originally are of color <a href=\"#keyColor-prop\">keyColor</a> should take.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$keyColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"keyColor-prop\"></a><span class=\"name\">keyColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The color of the pixels that should be colorized. By default it is set to #808080.</p>\n</div></div><!-- @@@keyColor -->\n<br/>\n<!-- $$$name -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"name-prop\"></a><span class=\"name\">name</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The name of the icon to display.</p>\n</div></div><!-- @@@name -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/477/", "name": "Icon", "description": "The Icon component displays an icon from the icon theme. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Icon", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Icon-brief -->\n<p>The Icon component displays an icon from the icon theme. <a href=\"#details\">More...</a></p>\n<!-- @@@Icon -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#keyColor-prop\">keyColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#name-prop\">name</a></b></b> : string</li>\n</ul>\n<!-- $$$Icon-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The icon theme contains a set of standard icons referred to by their name. Using icons whenever possible enhances consistency accross applications. Each icon has a name and can have different visual representations depending on the size requested.</p>\n<p>Icons can also be colorized. Setting the <a href=\"#color-prop\">color</a> property will make all pixels with the <a href=\"#keyColor-prop\">keyColor</a> (by default #808080) colored.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Icon</span> {\n <span class=\"name\">width</span>: <span class=\"number\">64</span>\n <span class=\"name\">height</span>: <span class=\"number\">64</span>\n <span class=\"name\">name</span>: <span class=\"string\">&quot;search&quot;</span>\n}</pre>\n<p>Example of colorization:</p>\n<pre class=\"qml\"><span class=\"type\">Icon</span> {\n <span class=\"name\">width</span>: <span class=\"number\">64</span>\n <span class=\"name\">height</span>: <span class=\"number\">64</span>\n <span class=\"name\">name</span>: <span class=\"string\">&quot;search&quot;</span>\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">warmGrey</span>\n}</pre>\n<p>Icon themes are created following the <a href=\"http://standards.freedesktop.org/icon-theme-spec/icon-theme-spec-latest.html\">Freedesktop Icon Theme Specification</a>.</p>\n<!-- @@@Icon -->\n<h2>Property Documentation</h2>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The color that all pixels that originally are of color <a href=\"#keyColor-prop\">keyColor</a> should take.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$keyColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"keyColor-prop\"></a><span class=\"name\">keyColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The color of the pixels that should be colorized. By default it is set to #808080.</p>\n</div></div><!-- @@@keyColor -->\n<br/>\n<!-- $$$name -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"name-prop\"></a><span class=\"name\">name</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The name of the icon to display.</p>\n<p><b>Note: </b>The complete list of icons available in Ubuntu is not published yet. For now please refer to the folders where the icon themes are installed:</p><ul>\n<li>Ubuntu Touch: <a href=\"file:/usr/share/icons/ubuntu-mobile\">/usr/share/icons/ubuntu-mobile</a></li>\n<li>Ubuntu Desktop: <a href=\"file:/usr/share/icons/ubuntu-mono-dark\">/usr/share/icons/ubuntu-mono-dark</a></li>\n</ul>\n<p>These 2 separate icon themes will be merged soon.</p>\n</div></div><!-- @@@name -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-icon.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/937/", "name": "InverseMouse", "description": "Attached object filtering mouse events occured outside the owner. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.InverseMouse", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$InverseMouse-brief -->\n<p>Attached object filtering mouse events occured outside the owner. <a href=\"#details\">More...</a></p>\n<!-- @@@InverseMouse -->\n<!-- $$$InverseMouse-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Similar to Mouse filter attached property, provides mouse event filtering capabilities but for events occurring outside of the owner's area, excluding the input method area.</p>\n<p>Being derived from Mouse filter element, provides the same behavior as the Mouse filter, except that all the signals are emitted when the mouse event occurs outside the owner's area. Note that accepting composed mouse events does not have any effect on event propagation.</p>\n<p>Altering <i>priority</i> property has no effect on inverse mouse filter as mouse events captured by the filter are not forwarded to the owner, hence forwarding those events first to the owner will not have any effect.</p>\n<!-- @@@InverseMouse -->\n</div></div>\n", "source_file": "qml-ubuntu-components0-inversemouse.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/517/", "name": "InverseMouseArea", "description": "The InverseMouseArea captures mouse events happening outside of a given area. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.InverseMouseArea", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$InverseMouseArea-brief -->\n<p>The InverseMouseArea captures mouse events happening outside of a given area. <a href=\"#details\">More...</a></p>\n<!-- @@@InverseMouseArea -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#sensingArea-prop\">sensingArea</a></b></b> : Item</li>\n<li class=\"fn\"><b><b><a href=\"#topmostItem-prop\">topmostItem</a></b></b> : bool</li>\n</ul>\n<!-- $$$InverseMouseArea-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>A typical use case is hiding of a popup or tooltip when the user presses or taps outside of the popup or tooltip area. The following example illustrates the use of InverseMouseArea in a Popup.</p>\n<p>Popup.qml</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">width</span>: <span class=\"number\">200</span>; <span class=\"name\">height</span>: <span class=\"number\">200</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;darkgray&quot;</span>\n <span class=\"name\">radius</span>: <span class=\"number\">10</span>\n <span class=\"type\">InverseMouseArea</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">acceptedButtons</span>: <span class=\"name\">Qt</span>.<span class=\"name\">LeftButton</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">parent</span>.<span class=\"name\">destroy</span>()\n }\n}</pre>\n<p>In the Popup above the mouse presses happening outside the area will cause closing and destroying the popup.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">width</span>: <span class=\"number\">640</span>\n <span class=\"name\">height</span>: <span class=\"number\">480</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">button</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Press me&quot;</span>\n <span class=\"name\">onClicked</span>: {\n var <span class=\"name\">component</span> = <span class=\"name\">Qt</span>.<span class=\"name\">createComponent</span>(<span class=\"string\">&quot;Popup.qml&quot;</span>);\n var <span class=\"name\">obj</span> = <span class=\"name\">component</span>.<span class=\"name\">create</span>(<span class=\"name\">parent</span>);\n <span class=\"name\">obj</span>.<span class=\"name\">visible</span> <span class=\"operator\">=</span> <span class=\"number\">true</span>;\n }\n }\n}</pre>\n<p>By default the InverseMouseArea sensing area (the area from which the mouse clicks will be taken) is the application's root component, or the Window in which the topmost parent component of the mouse area resides. This area can be however altered to a different area by setting the <a href=\"#sensingArea-prop\">sensingArea</a> property to a component which is either a parent of the mouse area or a sibling of it.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">71</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;clicked on the root component&quot;</span>)\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">blueRect</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">51</span>)\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;blue&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;red&quot;</span>\n <span class=\"type\">InverseMouseArea</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">sensingArea</span>: <span class=\"name\">blueRect</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;clicked on the blue rect&quot;</span>)\n }\n }\n }\n}</pre>\n<p>In this example the inverse mouse area will get mouse presses only when those happen on the blue rectangle area. When clicked outside of the blue rectangle or inside the red rectangle, the mouse area covering the root item will get click signals.</p>\n<p>InverseMouseArea, being derived from <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> respects the stacking and z-order of the components. This should be taken into account when combining it with MouseAreas within the same level of the component hierarchy or when combined with <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> siblings. In these cases it is recommended to have the InverseMouseArea declared as last component, having it in this way as last one oin the component stack.</p>\n<pre class=\"qml\"> <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">71</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">label</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">horizontalCenter</span>: <span class=\"name\">parent</span>.<span class=\"name\">horizontalCenter</span>\n <span class=\"name\">top</span>: <span class=\"name\">parent</span>.<span class=\"name\">top</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"name\">width</span>: <span class=\"name\">parent</span>.<span class=\"name\">width</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;red&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">z</span>: <span class=\"number\">1</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;red band&quot;</span>)\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"type\">anchors</span> {\n <span class=\"name\">top</span>: <span class=\"name\">label</span>.<span class=\"name\">bottom</span>\n <span class=\"name\">topMargin</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">2</span>)\n <span class=\"name\">horizontalCenter</span>: <span class=\"name\">parent</span>.<span class=\"name\">horizontalCenter</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">10</span>)\n <span class=\"name\">width</span>: <span class=\"name\">parent</span>.<span class=\"name\">width</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;green&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">button</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;I'm a button, I do nothing.&quot;</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;green band&quot;</span>)\n }\n <span class=\"type\">InverseMouseArea</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">button</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;all over except button&quot;</span>)\n }\n }\n}</pre>\n<p>When this is not enough, and you want to grab all the mouse events that have been sent to the <a href=\"#sensingArea-prop\">sensingArea</a>, you can use <a href=\"#topmostItem-prop\">topmostItem</a> to place the mouse area above all the components that were instantiated under the sensing area. Beware that setting this property will no longer consider neither the z-order nor the component stack order anymore, as it will steal all the mouse events from the component set as <a href=\"#sensingArea-prop\">sensingArea</a>.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">71</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">firstRect</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">top</span>: <span class=\"name\">parent</span>.<span class=\"name\">top</span>\n <span class=\"name\">leftMargin</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">10</span>)\n <span class=\"name\">topMargin</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">10</span>)\n }\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">15</span>)\n <span class=\"name\">height</span>: <span class=\"name\">width</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;blue&quot;</span>\n <span class=\"type\">InverseMouseArea</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">objectName</span>: <span class=\"string\">&quot;IMA&quot;</span>\n <span class=\"name\">topmostItem</span>: <span class=\"number\">true</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;IMA&quot;</span>)\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">firstRect</span>.<span class=\"name\">right</span>\n <span class=\"name\">top</span>: <span class=\"name\">firstRect</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">10</span>)\n <span class=\"name\">height</span>: <span class=\"name\">width</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;red&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">objectName</span>: <span class=\"string\">&quot;MA&quot;</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;MA&quot;</span>)\n }\n }\n}</pre>\n<!-- @@@InverseMouseArea -->\n<h2>Property Documentation</h2>\n<!-- $$$sensingArea -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"sensingArea-prop\"></a><span class=\"name\">sensingArea</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds the sensing area of the inverse mouse area. By default it is the root item but it can be set to any other area. The area can be reset to the root item by setting null to the property.</p>\n</div></div><!-- @@@sensingArea -->\n<br/>\n<!-- $$$topmostItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"topmostItem-prop\"></a><span class=\"name\">topmostItem</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property specifies whether the InverseMouseArea should be above all components taking all mouse, wheel and hover events from the application's or from the area specified by the <a href=\"#sensingArea-prop\">sensingArea</a> (true), or only from the siblings (false). The default value is false.</p>\n</div></div><!-- @@@topmostItem -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-inversemousearea.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/479/", "name": "Label", "description": "Text with Ubuntu styling. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Label", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Label-brief -->\n<p>Text with Ubuntu styling. <a href=\"#details\">More...</a></p>\n<!-- @@@Label -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.Text\">Text</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#fontSize-prop\">fontSize</a></b></b> : string</li>\n</ul>\n<!-- $$$Label-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">coolGrey</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"type\">Label</span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Hello, world!&quot;</span>\n <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;large&quot;</span>\n }\n}</pre>\n<!-- @@@Label -->\n<h2>Property Documentation</h2>\n<!-- $$$fontSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"fontSize-prop\"></a><span class=\"name\">fontSize</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The size of the text. One of the following strings (from smallest to largest):</p>\n<ul>\n<li>&quot;xx-small&quot;</li>\n<li>&quot;x-small&quot;</li>\n<li>&quot;small&quot;</li>\n<li>&quot;medium&quot;</li>\n<li>&quot;large&quot;</li>\n<li>&quot;x-large&quot;</li>\n</ul>\n<p>Default value is &quot;medium&quot;.</p>\n</div></div><!-- @@@fontSize -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-label.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/168/", "name": "Label", "description": "Text with Ubuntu styling. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Label", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Label-brief -->\n<p>Text with Ubuntu styling. <a href=\"#details\">More...</a></p>\n<!-- @@@Label -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#fontSize-prop\">fontSize</a></b></b> : string</li>\n</ul>\n<!-- $$$Label-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Rectangle</span> {\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">coolGrey</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"type\">Label</span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Hello, world!&quot;</span>\n <span class=\"name\">fontSize</span>: <span class=\"string\">&quot;large&quot;</span>\n }\n}</pre>\n<!-- @@@Label -->\n<h2>Property Documentation</h2>\n<!-- $$$fontSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"fontSize-prop\"></a><span class=\"name\">fontSize</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The size of the text. One of the following strings (from smallest to largest):</p>\n<ul>\n<li>&quot;xx-small&quot;</li>\n<li>&quot;x-small&quot;</li>\n<li>&quot;small&quot;</li>\n<li>&quot;medium&quot;</li>\n<li>&quot;large&quot;</li>\n<li>&quot;x-large&quot;</li>\n</ul>\n<p>Default value is &quot;medium&quot;.</p>\n</div></div><!-- @@@fontSize -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/169/", "name": "MainView", "description": "MainView is the root Item that should be used for all applications. It automatically adds a header and toolbar for its contents and can rotate its content based on the device orientation. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.MainView", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$MainView-brief -->\n<p>MainView is the root Item that should be used for all applications. It automatically adds a header and toolbar for its contents and can rotate its content based on the device orientation. <a href=\"#details\">More...</a></p>\n<!-- @@@MainView -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actionManager-prop\">actionManager</a></b></b> : UnityActions.ActionManager</li>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : list&lt;Action&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#anchorToKeyboard-prop\">anchorToKeyboard</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#applicationName-prop\">applicationName</a></b></b> : string<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#automaticOrientation-prop\">automaticOrientation</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#backgroundColor-prop\">backgroundColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#footerColor-prop\">footerColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#headerColor-prop\">headerColor</a></b></b> : color</li>\n</ul>\n<!-- $$$MainView-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The simplest way to use a MainView is to include a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> object inside the MainView:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Simple page&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Push me&quot;</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">15</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;Click!&quot;</span>)\n }\n }\n}</pre>\n<p>It is not required to set the anchors of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> as it will automatically fill its parent. The MainView has a header that automatically shows the title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a>.</p>\n<p>For the MainView to automatically rotate its content following the orientation of the device, set the <a href=\"#automaticOrientation-prop\">automaticOrientation</a> property to true.</p>\n<p>If the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> inside the MainView includes a Flickable with enough contents for scrolling, the header will automatically hide and show when the user scrolls up or down:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page with Flickable&quot;</span>\n <span class=\"type\">Flickable</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">contentHeight</span>: <span class=\"name\">column</span>.<span class=\"name\">height</span>\n <span class=\"type\">Column</span> {\n <span class=\"name\">id</span>: <span class=\"name\">column</span>\n <span class=\"type\">Repeater</span> {\n <span class=\"name\">model</span>: <span class=\"number\">100</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;line &quot;</span><span class=\"operator\">+</span><span class=\"name\">index</span>\n }\n }\n }\n }\n }\n}</pre>\n<p>The same header behavior is automatic when using a ListView instead of a Flickable in the above example.</p>\n<p>A toolbar can be added to the application by setting the tools property of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a>:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page title&quot;</span>\n <span class=\"type\">Rectangle</span> {\n <span class=\"name\">id</span>: <span class=\"name\">rectangle</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">coolGrey</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;orange&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"name\">UbuntuColors</span>.<span class=\"name\">orange</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;purple&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"name\">UbuntuColors</span>.<span class=\"name\">lightAubergine</span>\n }\n }\n }\n }\n}</pre>\n<p>The toolbar is hidden by default, but will be made visible when the user performs a bottom-edge-swipe gesture, and hidden when the user swipes it out, or when the active <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> inside the MainView is changed. The examples above show how to include a single <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> inside a MainView, but more advanced application structures are possible using <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a> and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a>. See <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarItems/\">ToolbarItems</a> for details on how to to control the behavior and contents of the toolbar.</p>\n<!-- @@@MainView -->\n<h2>Property Documentation</h2>\n<!-- $$$actionManager -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actionManager-prop\"></a><span class=\"name\">actionManager</span> : <span class=\"type\">UnityActions</span>.<span class=\"type\">ActionManager</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The ActionManager that supervises the global and local ActionContexts. The <a href=\"#actions-prop\">actions</a> property should be used preferably since it covers most use cases. The ActionManager is accessible to have a more refined control over the actions, e.g&#x2e; if one wants to add/remove actions dynamically, create specific action contexts, etc.</p>\n</div></div><!-- @@@actionManager -->\n<br/>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\">list</span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>A global list of actions that will be available to the system (including HUD) as long as the application is running. For actions that are not always available to the system, but only when a certain <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> is active, see the actions property of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a>.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$anchorToKeyboard -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"anchorToKeyboard-prop\"></a><span class=\"name\">anchorToKeyboard</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property holds if the application should automatically resize the contents when the input method appears</p>\n<p>The default value is false.</p>\n</div></div><!-- @@@anchorToKeyboard -->\n<br/>\n<!-- $$$applicationName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"applicationName-prop\"></a><span class=\"name\">applicationName</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property holds the application's name, which must be the same as the desktop file's name.</p>\n</div></div><!-- @@@applicationName -->\n<br/>\n<!-- $$$automaticOrientation -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"automaticOrientation-prop\"></a><span class=\"name\">automaticOrientation</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether the application will be automatically rotating when the device is.</p>\n<p>The default value is false.</p>\n</div></div><!-- @@@automaticOrientation -->\n<br/>\n<!-- $$$backgroundColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"backgroundColor-prop\"></a><span class=\"name\">backgroundColor</span> : <span class=\"type\">color</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the background.</p>\n<p>The background is usually a single color. However if <a href=\"#headerColor-prop\">headerColor</a> or <a href=\"#footerColor-prop\">footerColor</a> are set then a gradient of colors will be drawn.</p>\n<p>For example, in order for the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> to draw a color gradient beneath the content:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"name\">headerColor</span>: <span class=\"string\">&quot;#343C60&quot;</span>\n <span class=\"name\">backgroundColor</span>: <span class=\"string\">&quot;#6A69A2&quot;</span>\n <span class=\"name\">footerColor</span>: <span class=\"string\">&quot;#8896D5&quot;</span>\n}</pre>\n<p><b>See also </b><a href=\"#footerColor-prop\">footerColor</a> and <a href=\"#headerColor-prop\">headerColor</a>.</p>\n</div></div><!-- @@@backgroundColor -->\n<br/>\n<!-- $$$footerColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"footerColor-prop\"></a><span class=\"name\">footerColor</span> : <span class=\"type\">color</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the footer's background.</p>\n<p><b>See also </b><a href=\"#backgroundColor-prop\">backgroundColor</a> and <a href=\"#headerColor-prop\">headerColor</a>.</p>\n</div></div><!-- @@@footerColor -->\n<br/>\n<!-- $$$headerColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"headerColor-prop\"></a><span class=\"name\">headerColor</span> : <span class=\"type\">color</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the header's background.</p>\n<p><b>See also </b><a href=\"#backgroundColor-prop\">backgroundColor</a> and <a href=\"#footerColor-prop\">footerColor</a>.</p>\n</div></div><!-- @@@headerColor -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/480/", "name": "MainView", "description": "MainView is the root Item that should be used for all applications. It automatically adds a header and toolbar for its contents and can rotate its content based on the device orientation. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.MainView", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$MainView-brief -->\n<p>MainView is the root Item that should be used for all applications. It automatically adds a header and toolbar for its contents and can rotate its content based on the device orientation. <a href=\"#details\">More...</a></p>\n<!-- @@@MainView -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actionManager-prop\">actionManager</a></b></b> : UnityActions.ActionManager</li>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : list&lt;Action&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#anchorToKeyboard-prop\">anchorToKeyboard</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#applicationName-prop\">applicationName</a></b></b> : string<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#automaticOrientation-prop\">automaticOrientation</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#backgroundColor-prop\">backgroundColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#footerColor-prop\">footerColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#headerColor-prop\">headerColor</a></b></b> : color</li>\n</ul>\n<!-- $$$MainView-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The simplest way to use a MainView is to include a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> object inside the MainView:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Simple page&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Push me&quot;</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">15</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;Click!&quot;</span>)\n }\n }\n}</pre>\n<p>It is not required to set the anchors of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> as it will automatically fill its parent. The MainView has a header that automatically shows the title of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a>.</p>\n<p>For the MainView to automatically rotate its content following the orientation of the device, set the <a href=\"#automaticOrientation-prop\">automaticOrientation</a> property to true.</p>\n<p>If the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> inside the MainView includes a Flickable with enough contents for scrolling, the header will automatically hide and show when the user scrolls up or down:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page with Flickable&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Flickable\">Flickable</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">contentHeight</span>: <span class=\"name\">column</span>.<span class=\"name\">height</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Column\">Column</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">column</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Repeater\">Repeater</a></span> {\n <span class=\"name\">model</span>: <span class=\"number\">100</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;line &quot;</span><span class=\"operator\">+</span><span class=\"name\">index</span>\n }\n }\n }\n }\n }\n}</pre>\n<p>The same header behavior is automatic when using a <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a> instead of a Flickable in the above example.</p>\n<p>A toolbar can be added to the application by setting the tools property of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a>:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainView</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page title&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">rectangle</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">color</span>: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">coolGrey</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;orange&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"name\">UbuntuColors</span>.<span class=\"name\">orange</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;purple&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span> <span class=\"operator\">=</span> <span class=\"name\">UbuntuColors</span>.<span class=\"name\">lightAubergine</span>\n }\n }\n }\n }\n}</pre>\n<p>The toolbar is hidden by default, but will be made visible when the user performs a bottom-edge-swipe gesture, and hidden when the user swipes it out, or when the active <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> inside the MainView is changed. The examples above show how to include a single <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> inside a MainView, but more advanced application structures are possible using <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a> and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a>. See <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarItems\">ToolbarItems</a> for details on how to to control the behavior and contents of the toolbar.</p>\n<!-- @@@MainView -->\n<h2>Property Documentation</h2>\n<!-- $$$actionManager -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actionManager-prop\"></a><span class=\"name\">actionManager</span> : <span class=\"type\">UnityActions</span>.<span class=\"type\">ActionManager</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The ActionManager that supervises the global and local ActionContexts. The <a href=\"#actions-prop\">actions</a> property should be used preferably since it covers most use cases. The ActionManager is accessible to have a more refined control over the actions, e.g&#x2e; if one wants to add/remove actions dynamically, create specific action contexts, etc.</p>\n</div></div><!-- @@@actionManager -->\n<br/>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\">Action</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>A global list of actions that will be available to the system (including HUD) as long as the application is running. For actions that are not always available to the system, but only when a certain Page is active, see the actions property of Page.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$anchorToKeyboard -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"anchorToKeyboard-prop\"></a><span class=\"name\">anchorToKeyboard</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property holds if the application should automatically resize the contents when the input method appears</p>\n<p>The default value is false.</p>\n</div></div><!-- @@@anchorToKeyboard -->\n<br/>\n<!-- $$$applicationName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"applicationName-prop\"></a><span class=\"name\">applicationName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property holds the application's name, which must be the same as the desktop file's name. The name also sets the name of the QCoreApplication and defaults for data and cache folders that work on the desktop and under confinement. C++ code that writes files may use QStandardPaths::writableLocation with QStandardPaths::DataLocation or QStandardPaths::CacheLocation.</p>\n</div></div><!-- @@@applicationName -->\n<br/>\n<!-- $$$automaticOrientation -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"automaticOrientation-prop\"></a><span class=\"name\">automaticOrientation</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether the application will be automatically rotating when the device is.</p>\n<p>The default value is false.</p>\n</div></div><!-- @@@automaticOrientation -->\n<br/>\n<!-- $$$backgroundColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"backgroundColor-prop\"></a><span class=\"name\">backgroundColor</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qml-color.html\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the background.</p>\n<p>The background is usually a single color. However if <a href=\"#headerColor-prop\">headerColor</a> or <a href=\"#footerColor-prop\">footerColor</a> are set then a gradient of colors will be drawn.</p>\n<p>For example, in order for the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> to draw a color gradient beneath the content:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"name\">headerColor</span>: <span class=\"string\">&quot;#343C60&quot;</span>\n <span class=\"name\">backgroundColor</span>: <span class=\"string\">&quot;#6A69A2&quot;</span>\n <span class=\"name\">footerColor</span>: <span class=\"string\">&quot;#8896D5&quot;</span>\n}</pre>\n<p><b>See also </b><a href=\"#footerColor-prop\">footerColor</a> and <a href=\"#headerColor-prop\">headerColor</a>.</p>\n</div></div><!-- @@@backgroundColor -->\n<br/>\n<!-- $$$footerColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"footerColor-prop\"></a><span class=\"name\">footerColor</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qml-color.html\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the footer's background.</p>\n<p><b>See also </b><a href=\"#backgroundColor-prop\">backgroundColor</a> and <a href=\"#headerColor-prop\">headerColor</a>.</p>\n</div></div><!-- @@@footerColor -->\n<br/>\n<!-- $$$headerColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"headerColor-prop\"></a><span class=\"name\">headerColor</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qml-color.html\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Color of the header's background.</p>\n<p><b>See also </b><a href=\"#backgroundColor-prop\">backgroundColor</a> and <a href=\"#footerColor-prop\">footerColor</a>.</p>\n</div></div><!-- @@@headerColor -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-mainview.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/519/", "name": "MimeData", "description": "MimeData type provides interface to access and store data to the Clipboard. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.MimeData", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$MimeData-brief -->\n<p>MimeData type provides interface to access and store data to the Clipboard. <a href=\"#details\">More...</a></p>\n<!-- @@@MimeData -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#data-prop\">data</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#format-prop\">format</a></b></b> : list&lt;string&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#html-prop\">html</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#urls-prop\">urls</a></b></b> : list&lt;url&gt;</li>\n</ul>\n<!-- $$$MimeData-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<!-- @@@MimeData -->\n<h2>Property Documentation</h2>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qml-color.html\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"></div></div><!-- @@@color -->\n<br/>\n<!-- $$$data -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"data-prop\"></a><span class=\"name\">data</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Reading the property returns a list of MIME type and data pairs representing the data stored in the object. Users can set custom MIME types which are not covered by the other properties.</p>\n<p>When setting the property value can take one of the following types:</p>\n<ul>\n<li>- string - the data will be set as <tt>text/plain</tt> MIME type, or as <tt>text/html</tt> in case HTML tags are detected</li>\n<li>- color - the data will be set as <tt>application/x-color</tt> MIME type</li>\n<li>- list&lt;url&gt; - the data will be set as <tt>text/uri-list</tt></li>\n<li>- list&lt;string&gt; - the data will be set as <tt>text/uri-list</tt> in case the first element of the list is a valid URL with scheme; otherwise if the list size is even, the list will be set as pairs of (MIME type,data)</li>\n<li>- list&lt;var&gt; - same as list&lt;url&gt; or list&lt;string&gt;</li>\n</ul>\n</div></div><!-- @@@data -->\n<br/>\n<!-- $$$format -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"format-prop\"></a><span class=\"name\">format</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns a list of formats supported by the object. This is a list of MIME types for which the object can return suitable data. The formats in the list are in a priority order.</p>\n<p><b>See also </b><a href=\"#data-prop\">data</a>.</p>\n</div></div><!-- @@@format -->\n<br/>\n<!-- $$$html -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"html-prop\"></a><span class=\"name\">html</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a string if the data stored in the object is HTML (MIME type text/html); otherwise contains an empty string.</p>\n</div></div><!-- @@@html -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a plain text (MIME type text/plain) representation of the data.</p>\n</div></div><!-- @@@text -->\n<br/>\n<!-- $$$urls -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"urls-prop\"></a><span class=\"name\">urls</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a list of URLs contained within the MIME data object. URLs correspond to the MIME type text/uri-list.</p>\n</div></div><!-- @@@urls -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-mimedata.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/206/", "name": "MimeData", "description": "MimeData type provides interface to access and store data to the Clipboard. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.MimeData", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$MimeData-brief -->\n<p>MimeData type provides interface to access and store data to the Clipboard. <a href=\"#details\">More...</a></p>\n<!-- @@@MimeData -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#data-prop\">data</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#format-prop\">format</a></b></b> : list&lt;string&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#html-prop\">html</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#urls-prop\">urls</a></b></b> : list&lt;url&gt;</li>\n</ul>\n<!-- $$$MimeData-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<!-- @@@MimeData -->\n<h2>Property Documentation</h2>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\">color</span></p></td></tr></table></div><div class=\"qmldoc\"></div></div><!-- @@@color -->\n<br/>\n<!-- $$$data -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"data-prop\"></a><span class=\"name\">data</span> : <span class=\"type\">var</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Reading the property returns a list of MIME type and data pairs representing the data stored in the object. Users can set custom MIME types which are not covered by the other properties.</p>\n<p>When setting the property value can take one of the following types:</p>\n<ul>\n<li>- string - the data will be set as <tt>text/plain</tt> MIME type, or as <tt>text/html</tt> in case HTML tags are detected</li>\n<li>- color - the data will be set as <tt>application/x-color</tt> MIME type</li>\n<li>- list&lt;url&gt; - the data will be set as <tt>text/uri-list</tt></li>\n<li>- list&lt;string&gt; - the data will be set as <tt>text/uri-list</tt> in case the first element of the list is a valid URL with scheme; otherwise if the list size is even, the list will be set as pairs of (MIME type,data)</li>\n<li>- list&lt;var&gt; - same as list&lt;url&gt; or list&lt;string&gt;</li>\n</ul>\n</div></div><!-- @@@data -->\n<br/>\n<!-- $$$format -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"format-prop\"></a><span class=\"name\">format</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">string</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns a list of formats supported by the object. This is a list of MIME types for which the object can return suitable data. The formats in the list are in a priority order.</p>\n<p><b>See also </b><a href=\"#data-prop\">data</a>.</p>\n</div></div><!-- @@@format -->\n<br/>\n<!-- $$$html -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"html-prop\"></a><span class=\"name\">html</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a string if the data stored in the object is HTML (MIME type text/html); otherwise contains an empty string.</p>\n</div></div><!-- @@@html -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a plain text (MIME type text/plain) representation of the data.</p>\n</div></div><!-- @@@text -->\n<br/>\n<!-- $$$urls -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"urls-prop\"></a><span class=\"name\">urls</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">url</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Contains a list of URLs contained within the MIME data object. URLs correspond to the MIME type text/uri-list.</p>\n</div></div><!-- @@@urls -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/938/", "name": "Mouse", "description": "Attached property filtering mouse events occured inside the owner. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Mouse", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Mouse-brief -->\n<p>Attached property filtering mouse events occured inside the owner. <a href=\"#details\">More...</a></p>\n<!-- @@@Mouse -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#acceptedButtons-prop\">acceptedButtons</a></b></b> : Qt::MouseButtons</li>\n<li class=\"fn\"><b><b><a href=\"#clickAndHoldThreshold-prop\">clickAndHoldThreshold</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#enabled-prop\">enabled</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#forwardTo-prop\">forwardTo</a></b></b> : list&lt;Item&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#hoverEnabled-prop\">hoverEnabled</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#priority-prop\">priority</a></b></b> : enumeration</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onClicked-signal\">onClicked</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onDoubleClicked-signal\">onDoubleClicked</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onEntered-signal\">onEntered</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onExited-signal\">onExited</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onPositionChanged-signal\">onPositionChanged</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onPressAndHold-signal\">onPressAndHold</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onPressed-signal\">onPressed</a></b></b>(MouseEvent <i>event</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#onReleased-signal\">onReleased</a></b></b>(MouseEvent <i>event</i>)</li>\n</ul>\n<!-- $$$Mouse-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Sometimes we need to provide additional functionality on mouse events beside a QML element's default behavior. Placing a <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> over a component however will grab the mouse events from the component underneath, no matter if we set <i>preventStealing</i> to false or not. Setting mouse.accepted to false in <i>onPressed</i> would result in having the event forwarded to the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a>'s parent, however <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> will no longer receive other mouse events.</p>\n<pre class=\"qml\">import QtQuick 2.0\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"number\">100</span>\n <span class=\"name\">height</span>: <span class=\"number\">20</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">preventStealing</span>: <span class=\"number\">false</span>\n <span class=\"comment\">// do not accept event so it gets propagated to the parent item</span>\n <span class=\"name\">onPressed</span>: <span class=\"name\">mouse</span>.<span class=\"name\">accepted</span> <span class=\"operator\">=</span> <span class=\"number\">false</span>;\n <span class=\"name\">onReleased</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;this will not be printed&quot;</span>)\n }\n}</pre>\n<p>Ubuntu UI Toolkit declares filter components similar to Keys, which can be attached to any visual primitve. Mouse filter however will have effect only when attached to items handling mouse events. Events are handled through signals, where the event data is presented through the <i>mouse</i> parameter. Events should be accepted if the propagation of those to the owner is not wanted. This is not valid to <a href=\"#onClicked-signal\">onClicked</a>, <a href=\"#onPressAndHold-signal\">onPressAndHold</a> composed events.</p>\n<p>The previous code sample using Mouse filter, which will print the pressed and released mouse buttons would look as follows:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"number\">100</span>\n <span class=\"name\">height</span>: <span class=\"number\">20</span>\n <span class=\"comment\">// do not accept event so it gets propagated to the parent item</span>\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;mouse button pressed: &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">mouse</span>.<span class=\"name\">button</span>)\n <span class=\"name\">Mouse</span>.onReleased: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;mouse button released: &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">mouse</span>.<span class=\"name\">button</span>)\n}</pre>\n<p>The event details are reported in the <i>mouse</i> parameter, of <a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a> type, which extends <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qtquick-module.html\">QtQuick</a>'s <a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a> with additional properties.</p>\n<p>The filter will accept the same mouse buttons the owner accepts, and will accept hover events if the owner does. However it is not possible to alter these settings through the filter. If button handling other than the default ones specified for the primitive is required, MouseAreas can be declared to handle those events.</p>\n<p>Example of handling right button clicks over a <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"number\">100</span>\n <span class=\"name\">height</span>: <span class=\"number\">20</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">acceptedButtons</span>: <span class=\"name\">Qt</span>.<span class=\"name\">RightButton</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;right button clicked&quot;</span>)\n }\n}</pre>\n<p>In this example left and middle mouse button clicks will reach <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> as <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> only grabs right button events.</p>\n<p>Mouse filter can be used in combination with <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a>, where the filter brings additional functionality on top of existing primitive functionality, and <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> add new functionality to the primitive.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"number\">100</span>\n <span class=\"name\">height</span>: <span class=\"number\">20</span>\n <span class=\"comment\">// do not accept event so it gets propagated to the parent item</span>\n <span class=\"name\">Mouse</span>.onPressed: {\n <span class=\"keyword\">if</span> (<span class=\"name\">mouse</span>.<span class=\"name\">button</span> <span class=\"operator\">===</span> <span class=\"name\">Qt</span>.<span class=\"name\">LeftButton</span>) {\n <span class=\"comment\">// do something</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">acceptedButtons</span>: <span class=\"name\">Qt</span>.<span class=\"name\">RightButton</span>\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;right button clicked&quot;</span>)\n }\n}</pre>\n<p>As mentioned, mouse filters can be attached to any visual item. Attaching it to items that do not handle any mouse events will not have any effect. However child items which handle mouse events can forward the events they handle to their parent. In this way mouse events will land in these items too, and mouse filter attached to those can also handle the event. This is useful when creating custom types where the mouse handling item is nested into a non-mouse handling one, and we want to provide additional filtering possibility to the user.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">top</span>\n <span class=\"name\">width</span>: <span class=\"number\">100</span>\n <span class=\"name\">height</span>: <span class=\"number\">50</span>\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;mouse received from input&quot;</span>)\n <span class=\"type\">TextItem</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">Mouse</span>.forvardTo: [<span class=\"name\">top</span>]\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;pressed over input&quot;</span>)\n <span class=\"name\">Mouse</span>.onPressAndHold: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;longpress handled here&quot;</span>)\n }\n}</pre>\n<p>In this example the mouse press is first handled by the mouse filter attached to <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>, then it is forwarded to the top item and finally to the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>. Accepting the mouse event will stop propagation to the top item as well as to the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.</p>\n<p>An interesting feature that can be achieved using Mouse filter is the event &quot;transparency&quot; towards the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> lying behind the items which handle mouse events. This means for example that by forwarding mouse events occurred on a <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> to a <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> that stays behind it in the item hierarchy, the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> will also get all the events occurred on the area covered by the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>, acting like it would be above the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>. However, due to the nature of the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> event acceptance policy (all events are accepted by default) <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> will not get these mouse events unless we set the <i>accepted</i> field of the mouse event to false in <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a>. This normally leads to the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> no longer getting further mouse events. However, Mouse filter will continue to forward other mouse events to the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a>, so setting <i>accepted</i> to false in <i>onPressed</i>, <i>onReleased</i> will not have the default effect. This is only valid to press and release events, double-click or mouse position change will be blocked by the <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a> still.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">topArea</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">50</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">10</span>)\n <span class=\"name\">onPressed</span>: {\n <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;forwarded pressed&quot;</span>)\n <span class=\"name\">mouse</span>.<span class=\"name\">accepted</span> <span class=\"operator\">=</span> <span class=\"number\">false</span>\n }\n <span class=\"name\">onReleased</span>: {\n <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;released&quot;</span>)\n <span class=\"name\">mouse</span>.<span class=\"name\">accepted</span> <span class=\"operator\">=</span> <span class=\"number\">false</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">Mouse</span>.forwardTo: [<span class=\"name\">topArea</span>]\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;input pressed&quot;</span>)\n <span class=\"name\">Mouse</span>.onReleased: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;input released&quot;</span>)\n }\n}</pre>\n<p>Mouse filter provides ability to control the order of the event dispatching. The filter can receive the events prior the owner or after the owner. This can be controlled through the <a href=\"#priority-prop\">priority</a> property. In the following example we make sure the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> always receives the events before the filter:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">input</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"name\">activeFocusOnPress</span>: <span class=\"number\">true</span>\n <span class=\"name\">Mouse</span>.prority: <span class=\"name\">Mouse</span>.<span class=\"name\">AfterItem</span>\n <span class=\"name\">Mouse</span>.onPressed: <span class=\"keyword\">if</span> (<span class=\"name\">input</span>.<span class=\"name\">activeFocus</span>) <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;Text input already handled it&quot;</span>)\n}</pre>\n<p>Another feature of the mouse filters is the ability to restrict when the composed events like <a href=\"#onClicked-signal\">onClicked</a> and <a href=\"#onPressAndHold-signal\">onPressAndHold</a> should be triggered. By default these events are triggered no matter what is the distance between the mouse pressed position and the current position after a certain timeout (for <a href=\"#onPressAndHold-signal\">onPressAndHold</a>) or upon mouse release (for <a href=\"#onClicked-signal\">onClicked</a>). In this way the <a href=\"#onClicked-signal\">onClicked</a> will be emitted even if the user presses the mouse at the left-top edge of the component, then moves it to the right-bottom corner and releases it. This may not be the preferred behavior on certain components (like <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>). Therefore MouseFilter provides a property which can alter this behavior, the <a href=\"#clickAndHoldThreshold-prop\">clickAndHoldThreshold</a>. This property specifies the radius of the area the up-mentioned composed events are emitted during a mouse move.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"name\">activeFocusOnPress</span>: <span class=\"number\">true</span>\n <span class=\"name\">selectByMouse</span>: <span class=\"number\">true</span>\n <span class=\"comment\">// emit composed events only if the mouse moves within 2 GU radius area</span>\n <span class=\"name\">Mouse</span>.clickAndHoldThreshold: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">2</span>)\n <span class=\"name\">Mouse</span>.onClicked: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;click happened within threshold value&quot;</span>)\n <span class=\"name\">Mouse</span>.onPressAndHold: <span class=\"name\">console</span>.<span class=\"name\">log</span>(<span class=\"string\">&quot;pressAndHold happened within threshold value&quot;</span>)\n}</pre>\n<p>Similar functionality for the case when the mouse event occurs outside of the owner is brought by the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.InverseMouse\">InverseMouse</a> attached property.</p>\n<!-- @@@Mouse -->\n<h2>Property Documentation</h2>\n<!-- $$$acceptedButtons -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"acceptedButtons-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">acceptedButtons</span> : <span class=\"type\">Qt::MouseButtons</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the accepted mouse buttons of the owner.</p>\n</div></div><!-- @@@acceptedButtons -->\n<br/>\n<!-- $$$clickAndHoldThreshold -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"clickAndHoldThreshold-prop\"></a><span class=\"name\">clickAndHoldThreshold</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the radius of the tolerance area the mouse can move in both x and y axis when the mouse is pressed, during which the composed events such as <a href=\"#onClicked-signal\">onClicked</a> and <a href=\"#onPressAndHold-signal\">onPressAndHold</a> will still be emitted. If the mouse is moved out of this area while the button is pressed, no composed events will be emitted.</p>\n<p>When this value is 0, the signals will be emitted as in <a href=\"/api/qml/sdk-14.04/QtQuick.MouseArea\">MouseArea</a>, meaning the composed events will come until the mouse is moved inside the owner's area.</p>\n<p>The default value is 0.</p>\n</div></div><!-- @@@clickAndHoldThreshold -->\n<br/>\n<!-- $$$enabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"enabled-prop\"></a><span class=\"name\">enabled</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"></div></div><!-- @@@enabled -->\n<br/>\n<!-- $$$forwardTo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"forwardTo-prop\"></a><span class=\"name\">forwardTo</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>The property provides a way to forward mouse presses, releases, moves and double click events to other items. This can be useful when you want other items to handle different parts of the same mouse event or to handle other mouse events.</p>\n<p>The items listed will receive the event only if the mouse event falls into their area. Once an item that has forwarded mouse events accepts the event, that will no longer be delivered to the rest of the items in the list. This rule is also applied on the owner when the priority is set to <i>BeforeItem</i>.</p>\n</div></div><!-- @@@forwardTo -->\n<br/>\n<!-- $$$hoverEnabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hoverEnabled-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">hoverEnabled</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property reports whether the owner accepts hover events or not. When events are accepted <a href=\"#onEntered-signal\">onEntered</a>, <a href=\"#onPositionChanged-signal\">onPositionChanged</a> and <a href=\"#onExited-signal\">onExited</a> signals containing the mouse cursor position.</p>\n</div></div><!-- @@@hoverEnabled -->\n<br/>\n<!-- $$$priority -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"priority-prop\"></a><span class=\"name\">priority</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property specifies the event dispach relation between the filter, the elements the event is forwarded to and the owner. Similar to Keys' <i>priority</i> property, the event dispach is performed in two ways: berfore (<i>BeforeItem</i>) or after (<i>AfterItem</i>) the owner receives the events.</p>\n<p>When <i>BeforeItem</i> is set the event dispach happens based as follows:</p>\n<ol class=\"i\">\n<li>the event is handled by the mouse filter</li>\n<li>if there are items listed in <a href=\"#forwardTo-prop\">forwardTo</a> property, the event will be forwarded to those items</li>\n<li>the event is handed over the owner.</li>\n</ol>\n <br />\n <p>When <i>AfterItem</i> is set the event dispach happens based as follows:</p>\n<ol class=\"i\">\n<li>the event is handed over the owner;</li>\n<li>the event is handled by the mouse filter;</li>\n<li>if there are items listed in <a href=\"#forwardTo-prop\">forwardTo</a> property, the event will be forwarded to those items.</li>\n</ol>\n<p>The default value is <i>BeforeItem</i>.</p>\n</div></div><!-- @@@priority -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$onClicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onClicked-signal\"></a>Mouse::<span class=\"name\">onClicked</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports the mouse click. The signal is not emitted if the <a href=\"#onPressAndHold-signal\">onPressAndHold</a> got triggered or if <a href=\"#onDoubleClicked-signal\">onDoubleClicked</a> is handled (a slot is connected to it).</p>\n</div></div><!-- @@@onClicked -->\n<br/>\n<!-- $$$onDoubleClicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onDoubleClicked-signal\"></a>Mouse::<span class=\"name\">onDoubleClicked</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports mouse double click.</p>\n</div></div><!-- @@@onDoubleClicked -->\n<br/>\n<!-- $$$onEntered -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onEntered-signal\"></a>Mouse::<span class=\"name\">onEntered</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports that the mouse has entered into the area. The signal is emitted when the hover events are enabled and the mouse enters the area or when one of the accepted mouse button is pressed.</p>\n</div></div><!-- @@@onEntered -->\n<br/>\n<!-- $$$onExited -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onExited-signal\"></a>Mouse::<span class=\"name\">onExited</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports that the mouse has left the area. The signal is emitted when the hover events are enabled for the owner or if not, when one of the accepted button is released.</p>\n</div></div><!-- @@@onExited -->\n<br/>\n<!-- $$$onPositionChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onPositionChanged-signal\"></a>Mouse::<span class=\"name\">onPositionChanged</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports the mouse pointer position change. If the hover events are enabled for the owner, the signal will come continuously. Otherwise the position chanes are reported when one of the accepted mouse buttons are being kept pressed.</p>\n</div></div><!-- @@@onPositionChanged -->\n<br/>\n<!-- $$$onPressAndHold -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onPressAndHold-signal\"></a>Mouse::<span class=\"name\">onPressAndHold</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports the mouse press and hold.</p>\n</div></div><!-- @@@onPressAndHold -->\n<br/>\n<!-- $$$onPressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onPressed-signal\"></a>Mouse::<span class=\"name\">onPressed</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports the mouse press.</p>\n</div></div><!-- @@@onPressed -->\n<br/>\n<!-- $$$onReleased -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onReleased-signal\"></a>Mouse::<span class=\"name\">onReleased</span>(<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.MouseEvent\">MouseEvent</a></span><i> event</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The signal reports the mouse release.</p>\n</div></div><!-- @@@onReleased -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-mouse.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/482/", "name": "OptionSelector", "description": "Component displaying either a single selected value or expanded multiple choice with an optional image and subtext when not expanded, when expanding it opens a listing of all the possible values for selection with an additional option of always being e...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.OptionSelector", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$OptionSelector-brief -->\n<p>Component displaying either a single selected value or expanded multiple choice with an optional image and subtext when not expanded, when expanding it opens a listing of all the possible values for selection with an additional option of always being expanded. If multiple choice is selected the list is expanded automatically. <a href=\"#details\">More...</a></p>\n<!-- @@@OptionSelector -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#colourImage-prop\">colourImage</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#containerHeight-prop\">containerHeight</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#currentlyExpanded-prop\">currentlyExpanded</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#delegate-prop\">delegate</a></b></b> : Component<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#expanded-prop\">expanded</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#itemHeight-prop\">itemHeight</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#model-prop\">model</a></b></b> : var<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#multiSelection-prop\">multiSelection</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#selectedIndex-prop\">selectedIndex</a></b></b> : int</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#delegateClicked-signal\">delegateClicked</a></b></b>(int <i>index</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#expansionCompleted-signal\">expansionCompleted</a></b></b>()</li>\n</ul>\n<!-- $$$OptionSelector-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>Examples:</p>\n<pre class=\"qml\">import Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Column\">Column</a></span> {\n <span class=\"name\">spacing</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">3</span>)\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Label&quot;</span>)\n <span class=\"name\">model</span>: [<span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 1&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 2&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 3&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 4&quot;</span>)]\n }\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Label&quot;</span>)\n <span class=\"name\">expanded</span>: <span class=\"number\">true</span>\n <span class=\"name\">model</span>: [<span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 1&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 2&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 3&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 4&quot;</span>)]\n }\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">objectName</span>: <span class=\"string\">&quot;optionselector_multipleselection&quot;</span>\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Multiple Selection&quot;</span>)\n <span class=\"name\">expanded</span>: <span class=\"number\">false</span>\n <span class=\"name\">multiSelection</span>: <span class=\"number\">true</span>\n <span class=\"name\">model</span>: [<span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 1&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 2&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 3&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 4&quot;</span>)]\n }\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Label&quot;</span>)\n <span class=\"name\">model</span>: <span class=\"name\">customModel</span>\n <span class=\"name\">expanded</span>: <span class=\"number\">true</span>\n <span class=\"name\">colourImage</span>: <span class=\"number\">true</span>\n <span class=\"name\">delegate</span>: <span class=\"name\">selectorDelegate</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">selectorDelegate</span>\n <span class=\"type\">OptionSelectorDelegate</span> { <span class=\"name\">text</span>: <span class=\"name\">name</span>; <span class=\"name\">subText</span>: <span class=\"name\">description</span>; <span class=\"name\">iconSource</span>: <span class=\"name\">image</span> }\n }\n <span class=\"type\">ListModel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">customModel</span>\n <span class=\"type\">ListElement</span> { <span class=\"name\">name</span>: <span class=\"string\">&quot;Name 1&quot;</span>; <span class=\"name\">description</span>: <span class=\"string\">&quot;Description 1&quot;</span>; <span class=\"name\">image</span>: <span class=\"string\">&quot;images.png&quot;</span> }\n <span class=\"type\">ListElement</span> { <span class=\"name\">name</span>: <span class=\"string\">&quot;Name 2&quot;</span>; <span class=\"name\">description</span>: <span class=\"string\">&quot;Description 2&quot;</span>; <span class=\"name\">image</span>: <span class=\"string\">&quot;images.png&quot;</span> }\n <span class=\"type\">ListElement</span> { <span class=\"name\">name</span>: <span class=\"string\">&quot;Name 3&quot;</span>; <span class=\"name\">description</span>: <span class=\"string\">&quot;Description 3&quot;</span>; <span class=\"name\">image</span>: <span class=\"string\">&quot;images.png&quot;</span> }\n <span class=\"type\">ListElement</span> { <span class=\"name\">name</span>: <span class=\"string\">&quot;Name 4&quot;</span>; <span class=\"name\">description</span>: <span class=\"string\">&quot;Description 4&quot;</span>; <span class=\"name\">image</span>: <span class=\"string\">&quot;images.png&quot;</span> }\n }\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Label&quot;</span>)\n <span class=\"name\">model</span>: [<span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 1&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 2&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 3&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 4&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 5&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 6&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 7&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 8&quot;</span>)]\n <span class=\"name\">containerHeight</span>: <span class=\"name\">itemHeight</span> <span class=\"operator\">*</span> <span class=\"number\">4</span>\n }\n <span class=\"type\">OptionSelector</span> {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Label&quot;</span>)\n <span class=\"name\">expanded</span>: <span class=\"number\">true</span>\n <span class=\"name\">model</span>: [<span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 1&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 2&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 3&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 4&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 5&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 6&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 7&quot;</span>),\n <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Value 8&quot;</span>)]\n <span class=\"name\">containerHeight</span>: <span class=\"name\">itemHeight</span> <span class=\"operator\">*</span> <span class=\"number\">4</span>\n }\n}</pre>\n<!-- @@@OptionSelector -->\n<h2>Property Documentation</h2>\n<!-- $$$colourImage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"colourImage-prop\"></a><span class=\"name\">colourImage</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Colours image according to the fieldText colour of the theme, otherwise source colour is maintained.</p>\n</div></div><!-- @@@colourImage -->\n<br/>\n<!-- $$$containerHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"containerHeight-prop\"></a><span class=\"name\">containerHeight</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Custom height for list container which allows scrolling inside the selector.</p>\n</div></div><!-- @@@containerHeight -->\n<br/>\n<!-- $$$currentlyExpanded -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"currentlyExpanded-prop\"></a><span class=\"name\">currentlyExpanded</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Is our list currently expanded?</p>\n</div></div><!-- @@@currentlyExpanded -->\n<br/>\n<!-- $$$delegate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"delegate-prop\"></a><span class=\"name\">delegate</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a> delegate.</p>\n</div></div><!-- @@@delegate -->\n<br/>\n<!-- $$$expanded -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"expanded-prop\"></a><span class=\"name\">expanded</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies whether the list is always expanded.</p>\n</div></div><!-- @@@expanded -->\n<br/>\n<!-- $$$itemHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"itemHeight-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">itemHeight</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Height of an individual list item.</p>\n</div></div><!-- @@@itemHeight -->\n<br/>\n<!-- $$$model -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"model-prop\"></a><span class=\"name\">model</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The list of values that will be shown under the label text. This is a model.</p>\n</div></div><!-- @@@model -->\n<br/>\n<!-- $$$multiSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"multiSelection-prop\"></a><span class=\"name\">multiSelection</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>If the multiple choice selection is enabled the list is always expanded.</p>\n</div></div><!-- @@@multiSelection -->\n<br/>\n<!-- $$$selectedIndex -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedIndex-prop\"></a><span class=\"name\">selectedIndex</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The index of the currently selected element in our list.</p>\n</div></div><!-- @@@selectedIndex -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$delegateClicked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"delegateClicked-signal\"></a>OptionSelector::<span class=\"name\">delegateClicked</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span><i> index</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Called when delegate is clicked.</p>\n</div></div><!-- @@@delegateClicked -->\n<br/>\n<!-- $$$expansionCompleted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"expansionCompleted-signal\"></a>OptionSelector::<span class=\"name\">expansionCompleted</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Called when the selector has finished expanding or collapsing.</p>\n</div></div><!-- @@@expansionCompleted -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-optionselector.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/483/", "name": "OrientationHelper", "description": "The OrientationHelper automatically rotates its children following the orientation of the device. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.OrientationHelper", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$OrientationHelper-brief -->\n<p>The OrientationHelper automatically rotates its children following the orientation of the device. <a href=\"#details\">More...</a></p>\n<!-- @@@OrientationHelper -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Popups.PopupBase\">PopupBase</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#underscore._orientationAngle-prop\">__orientationAngle</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#automaticOrientation-prop\">automaticOrientation</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#orientationAngle-prop\">orientationAngle</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#rotating-prop\">rotating</a></b></b> : alias</li>\n<li class=\"fn\"><b><b><a href=\"#transitionEnabled-prop\">transitionEnabled</a></b></b> : bool</li>\n</ul>\n<!-- $$$OrientationHelper-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Any Item placed inside an Orientation Helper will be automatically rotated following the orientation of the device.</p>\n<p>Note that OrientationHelper is always filling its parent (anchors.parent: fill).</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">OrientationHelper</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Automatically rotated&quot;</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Automatically rotated&quot;</span>\n }\n }\n}</pre>\n<!-- @@@OrientationHelper -->\n<h2>Property Documentation</h2>\n<!-- $$$__orientationAngle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"underscore._orientationAngle-prop\"></a><span class=\"name\">__orientationAngle</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>Use <a href=\"#orientationAngle-prop\">orientationAngle</a> instead.</p>\n</div></div><!-- @@@__orientationAngle -->\n<br/>\n<!-- $$$automaticOrientation -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"automaticOrientation-prop\"></a><span class=\"name\">automaticOrientation</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether it will be automatically rotating when the device is.</p>\n<p>The default value is true.</p>\n</div></div><!-- @@@automaticOrientation -->\n<br/>\n<!-- $$$orientationAngle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"orientationAngle-prop\"></a><span class=\"name\">orientationAngle</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Calculates the current orientation angle.</p>\n</div></div><!-- @@@orientationAngle -->\n<br/>\n<!-- $$$rotating -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"rotating-prop\"></a><span class=\"name\">rotating</span> : <span class=\"type\">alias</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Exposes whether the orientationTransition is running.</p>\n</div></div><!-- @@@rotating -->\n<br/>\n<!-- $$$transitionEnabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"transitionEnabled-prop\"></a><span class=\"name\">transitionEnabled</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether the rotation transition is performed.</p>\n<p>The default value is true.</p>\n</div></div><!-- @@@transitionEnabled -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-orientationhelper.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/172/", "name": "OrientationHelper", "description": "The OrientationHelper automatically rotates its children following the orientation of the device. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.OrientationHelper", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$OrientationHelper-brief -->\n<p>The OrientationHelper automatically rotates its children following the orientation of the device. <a href=\"#details\">More...</a></p>\n<!-- @@@OrientationHelper -->\n<p>Inherited by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Popups.PopupBase/\">PopupBase</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#underscore._orientationAngle-prop\">__orientationAngle</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#automaticOrientation-prop\">automaticOrientation</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#orientationAngle-prop\">orientationAngle</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#rotating-prop\">rotating</a></b></b> : alias</li>\n<li class=\"fn\"><b><b><a href=\"#transitionEnabled-prop\">transitionEnabled</a></b></b> : bool</li>\n</ul>\n<!-- $$$OrientationHelper-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Any Item placed inside an Orientation Helper will be automatically rotated following the orientation of the device.</p>\n<p>Note that OrientationHelper is always filling its parent (anchors.parent: fill).</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">OrientationHelper</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Automatically rotated&quot;</span>\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Automatically rotated&quot;</span>\n }\n }\n}</pre>\n<!-- @@@OrientationHelper -->\n<h2>Property Documentation</h2>\n<!-- $$$__orientationAngle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"underscore._orientationAngle-prop\"></a><span class=\"name\">__orientationAngle</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>Use <a href=\"#orientationAngle-prop\">orientationAngle</a> instead.</p>\n</div></div><!-- @@@__orientationAngle -->\n<br/>\n<!-- $$$automaticOrientation -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"automaticOrientation-prop\"></a><span class=\"name\">automaticOrientation</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether it will be automatically rotating when the device is.</p>\n<p>The default value is true.</p>\n</div></div><!-- @@@automaticOrientation -->\n<br/>\n<!-- $$$orientationAngle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"orientationAngle-prop\"></a><span class=\"name\">orientationAngle</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Calculates the current orientation angle.</p>\n</div></div><!-- @@@orientationAngle -->\n<br/>\n<!-- $$$rotating -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"rotating-prop\"></a><span class=\"name\">rotating</span> : <span class=\"type\">alias</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Exposes whether the orientationTransition is running.</p>\n</div></div><!-- @@@rotating -->\n<br/>\n<!-- $$$transitionEnabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"transitionEnabled-prop\"></a><span class=\"name\">transitionEnabled</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Sets whether the rotation transition is performed.</p>\n<p>The default value is true.</p>\n</div></div><!-- @@@transitionEnabled -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/173/", "name": "Page", "description": "A page is the basic Item that must be used inside the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a> and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Page", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Page-brief -->\n<p>A page is the basic Item that must be used inside the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a> and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a>. Anchors and height of a Page are automatically determined to align with the header of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>, but can be overridden. <a href=\"#details\">More...</a></p>\n<!-- @@@Page -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : list&lt;Action&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#flickable-prop\">flickable</a></b></b> : Flickable</li>\n<li class=\"fn\"><b><b><a href=\"#title-prop\">title</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#tools-prop\">tools</a></b></b> : Item</li>\n</ul>\n<!-- $$$Page-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> provides a header and toolbar for Pages it includes. Each page automatically has its header and toolbar property linked to that of its parent <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>. The text of the header, and the buttons in the toolbar are determined by the <a href=\"#title-prop\">title</a> and <a href=\"#tools-prop\">tools</a> properties of the page:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">Page</span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Example page&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Hello world!&quot;</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;one&quot;</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;two&quot;</span>\n }\n }\n }\n }\n}</pre>\n<p>See <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> for more basic examples that show how to use a header and toolbar. Advanced navigation structures can be created by adding Pages to a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a> or <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a>.</p>\n<!-- @@@Page -->\n<h2>Property Documentation</h2>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\">list</span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Action/\">Action</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Local actions. These actions will be made available outside the application (for example, to HUD) when the Page is active. For actions that are always available when the application is running, use the actions property of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$flickable -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"flickable-prop\"></a><span class=\"name\">flickable</span> : <span class=\"type\">Flickable</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Optional flickable that controls the header. This property is automatically set to the first child of the page that is Flickable and anchors to the top of the page or fills the page. For example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">50</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page</span>\n <span class=\"name\">title</span>: <span class=\"string\">&quot;example&quot;</span>\n <span class=\"comment\">//flickable: null // uncomment to disable hiding of the header</span>\n <span class=\"type\">Flickable</span> {\n <span class=\"name\">id</span>: <span class=\"name\">content</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">contentHeight</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">70</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;hello&quot;</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n }\n }\n }\n}</pre>\n<p>In this example, page.flickable will automatically be set to content because it is a Flickable and it fills its parent. Thus, scrolling down in the Flickable will automatically hide the header.</p>\n<p>This property be set to null to avoid automatic flickable detection, which disables hiding of the header by scrolling in the Flickable. In cases where a flickable should control the header, but it is not automatically detected, the flickable property can be set.</p>\n</div></div><!-- @@@flickable -->\n<br/>\n<!-- $$$title -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"title-prop\"></a><span class=\"name\">title</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the page. Will be shown in the header of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a>.</p>\n</div></div><!-- @@@title -->\n<br/>\n<!-- $$$tools -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tools-prop\"></a><span class=\"name\">tools</span> : <span class=\"type\">Item</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The toolbar items associated with this Page. It is recommended to use <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarItems/\">ToolbarItems</a> to specify the tools, but any Item is allowed here.</p>\n</div></div><!-- @@@tools -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/484/", "name": "Page", "description": "A page is the basic Item that must be used inside the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a> and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">T...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Page", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Page-brief -->\n<p>A page is the basic Item that must be used inside the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a> and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a>. Anchors and height of a Page are automatically determined to align with the header of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a>, but can be overridden. <a href=\"#details\">More...</a></p>\n<!-- @@@Page -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#actions-prop\">actions</a></b></b> : list&lt;Action&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#flickable-prop\">flickable</a></b></b> : Flickable</li>\n<li class=\"fn\"><b><b><a href=\"#title-prop\">title</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#tools-prop\">tools</a></b></b> : Item</li>\n</ul>\n<!-- $$$Page-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> provides a header and toolbar for Pages it includes. Each page automatically has its header and toolbar property linked to that of its parent <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a>. The text of the header, and the buttons in the toolbar are determined by the <a href=\"#title-prop\">title</a> and <a href=\"#tools-prop\">tools</a> properties of the page:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">Page</span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Example page&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Hello world!&quot;</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;one&quot;</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a></span> {\n <span class=\"name\">action</span>: <span class=\"name\">Action</span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;two&quot;</span>\n }\n }\n }\n }\n}</pre>\n<p>See <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> for more basic examples that show how to use a header and toolbar. Advanced navigation structures can be created by adding Pages to a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a> or <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a>.</p>\n<!-- @@@Page -->\n<h2>Property Documentation</h2>\n<!-- $$$actions -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"actions-prop\"></a><span class=\"name\">actions</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\">Action</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Local actions. These actions will be made available outside the application (for example, to HUD) when the Page is active. For actions that are always available when the application is running, use the actions property of MainView.</p>\n</div></div><!-- @@@actions -->\n<br/>\n<!-- $$$flickable -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"flickable-prop\"></a><span class=\"name\">flickable</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Flickable\">Flickable</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Optional flickable that controls the header. This property is automatically set to the first child of the page that is Flickable and anchors to the top of the page or fills the page. For example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">50</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page</span>\n <span class=\"name\">title</span>: <span class=\"string\">&quot;example&quot;</span>\n <span class=\"comment\">//flickable: null // uncomment to disable hiding of the header</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Flickable\">Flickable</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">content</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">contentHeight</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">70</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;hello&quot;</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n }\n }\n }\n}</pre>\n<p>In this example, page.flickable will automatically be set to content because it is a Flickable and it fills its parent. Thus, scrolling down in the Flickable will automatically hide the header.</p>\n<p>This property be set to null to avoid automatic flickable detection, which disables hiding of the header by scrolling in the Flickable. In cases where a flickable should control the header, but it is not automatically detected, the flickable property can be set.</p>\n</div></div><!-- @@@flickable -->\n<br/>\n<!-- $$$title -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"title-prop\"></a><span class=\"name\">title</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title of the page. Will be shown in the header of the MainView.</p>\n</div></div><!-- @@@title -->\n<br/>\n<!-- $$$tools -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tools-prop\"></a><span class=\"name\">tools</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The toolbar items associated with this Page. It is recommended to use <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarItems\">ToolbarItems</a> to specify the tools, but any Item is allowed here.</p>\n</div></div><!-- @@@tools -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-page.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/174/", "name": "PageStack", "description": "A stack of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> items that is used for inter-Page navigation. Pages on the stack can be popped, and new Pages can be pushed. The page on top of the stack is the visible one. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.PageStack", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$PageStack-brief -->\n<p>A stack of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> items that is used for inter-Page navigation. Pages on the stack can be popped, and new Pages can be pushed. The page on top of the stack is the visible one. <a href=\"#details\">More...</a></p>\n<!-- @@@PageStack -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#currentPage-prop\">currentPage</a></b></b> : Item<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#depth-prop\">depth</a></b></b> : int<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#clear-method\">clear</a></b></b>()<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#pop-method\">pop</a></b></b>()<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#push-method\">push</a></b></b>(<i>page</i>, <i>properties</i>)<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$PageStack-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>PageStack should be used inside a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> in order to automatically add a header and toolbar to control the stack. The PageStack will automatically set the header title to the title of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> that is currently on top of the stack, and the tools of the toolbar to the tools of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> on top of the stack. When more than one Pages are on the stack, the toolbar will automatically feature a back-button that pop the stack when triggered.</p>\n<p>Pages that are defined inside the PageStack must initially set their visibility to false to avoid the pages occluding the PageStack before they are pushed. When pushing a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a>, its visibility is automatically updated.</p>\n<p>Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1 as ListItem\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">PageStack</span> {\n <span class=\"name\">id</span>: <span class=\"name\">pageStack</span>\n <span class=\"name\">Component</span>.onCompleted: <span class=\"name\">push</span>(<span class=\"name\">page0</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page0</span>\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Root page&quot;</span>)\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n <span class=\"type\">Column</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"type\">ListItem</span>.Standard {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Page one&quot;</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">page1</span>, {color: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">orange</span>})\n <span class=\"name\">progression</span>: <span class=\"number\">true</span>\n }\n <span class=\"type\">ListItem</span>.Standard {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;External page&quot;</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">Qt</span>.<span class=\"name\">resolvedUrl</span>(<span class=\"string\">&quot;MyCustomPage.qml&quot;</span>))\n <span class=\"name\">progression</span>: <span class=\"number\">true</span>\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Rectangle&quot;</span>\n <span class=\"name\">id</span>: <span class=\"name\">page1</span>\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n property <span class=\"type\">alias</span> <span class=\"name\">color</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span>\n <span class=\"type\">Rectangle</span> {\n <span class=\"name\">id</span>: <span class=\"name\">rectangle</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">fill</span>: <span class=\"name\">parent</span>\n <span class=\"name\">margins</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n }\n }\n }\n }\n}</pre>\n<p>As shown in the example above, the <a href=\"#push-method\">push()</a> function can take an Item, Component or URL as input.</p>\n<!-- @@@PageStack -->\n<h2>Property Documentation</h2>\n<!-- $$$currentPage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"currentPage-prop\"></a><span class=\"name\">currentPage</span> : <span class=\"type\">Item</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The currently active page</p>\n</div></div><!-- @@@currentPage -->\n<br/>\n<!-- $$$depth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"depth-prop\"></a><span class=\"name\">depth</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The current size of the stack</p>\n</div></div><!-- @@@depth -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$clear -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clear-method\"></a>PageStack::<span class=\"name\">clear</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Deactivate the active page and clear the stack.</p>\n</div></div><!-- @@@clear -->\n<br/>\n<!-- $$$pop -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"pop-method\"></a>PageStack::<span class=\"name\">pop</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Pop the top item from the stack if the stack size is at least 1. Do not do anything if 0 or 1 items are on the stack.</p>\n</div></div><!-- @@@pop -->\n<br/>\n<!-- $$$push -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"push-method\"></a>PageStack::<span class=\"name\">push</span>(<i> page</i>, <i> properties</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Push a page to the stack, and apply the given (optional) properties to the page. The pushed page may be an Item, Component or URL.</p>\n</div></div><!-- @@@push -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/485/", "name": "PageStack", "description": "A stack of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> items that is used for inter-Page navigation. Pages on the stack can be popped, and new Pages can be pushed. The page on top of the stack is the visible one. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.PageStack", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$PageStack-brief -->\n<p>A stack of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> items that is used for inter-Page navigation. Pages on the stack can be popped, and new Pages can be pushed. The page on top of the stack is the visible one. <a href=\"#details\">More...</a></p>\n<!-- @@@PageStack -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#currentPage-prop\">currentPage</a></b></b> : Item<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#depth-prop\">depth</a></b></b> : int<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#clear-method\">clear</a></b></b>()<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#pop-method\">pop</a></b></b>()<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#push-method\">push</a></b></b>(<i>page</i>, <i>properties</i>)<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$PageStack-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>PageStack should be used inside a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> in order to automatically add a header and toolbar to control the stack. The PageStack will automatically set the header title to the title of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> that is currently on top of the stack, and the tools of the toolbar to the tools of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> on top of the stack. When more than one Pages are on the stack, the toolbar will automatically feature a back-button that pop the stack when triggered.</p>\n<p>Pages that are defined inside the PageStack must initially set their visibility to false to avoid the pages occluding the PageStack before they are pushed. When pushing a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a>, its visibility is automatically updated.</p>\n<p>Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1 as ListItem\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">PageStack</span> {\n <span class=\"name\">id</span>: <span class=\"name\">pageStack</span>\n <span class=\"name\">Component</span>.onCompleted: <span class=\"name\">push</span>(<span class=\"name\">page0</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page0</span>\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Root page&quot;</span>)\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Column\">Column</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"type\">ListItem</span>.Standard {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Page one&quot;</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">page1</span>, {color: <span class=\"name\">UbuntuColors</span>.<span class=\"name\">orange</span>})\n <span class=\"name\">progression</span>: <span class=\"number\">true</span>\n }\n <span class=\"type\">ListItem</span>.Standard {\n <span class=\"name\">text</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;External page&quot;</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">Qt</span>.<span class=\"name\">resolvedUrl</span>(<span class=\"string\">&quot;MyCustomPage.qml&quot;</span>))\n <span class=\"name\">progression</span>: <span class=\"number\">true</span>\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Rectangle&quot;</span>\n <span class=\"name\">id</span>: <span class=\"name\">page1</span>\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n property <span class=\"type\">alias</span> <span class=\"name\">color</span>: <span class=\"name\">rectangle</span>.<span class=\"name\">color</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">rectangle</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">fill</span>: <span class=\"name\">parent</span>\n <span class=\"name\">margins</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n }\n }\n }\n }\n}</pre>\n<p>As shown in the example above, the <a href=\"#push-method\">push()</a> function can take an Item, Component or URL as input.</p>\n<!-- @@@PageStack -->\n<h2>Property Documentation</h2>\n<!-- $$$currentPage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"currentPage-prop\"></a><span class=\"name\">currentPage</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The currently active page</p>\n</div></div><!-- @@@currentPage -->\n<br/>\n<!-- $$$depth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"depth-prop\"></a><span class=\"name\">depth</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The current size of the stack</p>\n</div></div><!-- @@@depth -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$clear -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"clear-method\"></a>PageStack::<span class=\"name\">clear</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Deactivate the active page and clear the stack.</p>\n</div></div><!-- @@@clear -->\n<br/>\n<!-- $$$pop -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"pop-method\"></a>PageStack::<span class=\"name\">pop</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Pop the top item from the stack if the stack size is at least 1. Do not do anything if 0 or 1 items are on the stack.</p>\n</div></div><!-- @@@pop -->\n<br/>\n<!-- $$$push -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"push-method\"></a>PageStack::<span class=\"name\">push</span>(<i> page</i>, <i> properties</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Push a page to the stack, and apply the given (optional) properties to the page. The pushed page may be an Item, Component or URL.</p>\n</div></div><!-- @@@push -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-pagestack.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/177/", "name": "Panel", "description": "A panel that can be swiped in and out from an edge of the window by the user. For most applications, it is highly recommended to use the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> instead which includes a toolbar at its bottom ...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Panel", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Panel-brief -->\n<p>A panel that can be swiped in and out from an edge of the window by the user. For most applications, it is highly recommended to use the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> instead which includes a toolbar at its bottom that can be swiped in or out. <a href=\"#details\">More...</a></p>\n<!-- @@@Panel -->\n<p>Inherited by Toolbar.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#align-prop\">align</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#animating-prop\">animating</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#contents-prop\">contents</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#hintSize-prop\">hintSize</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#locked-prop\">locked</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#opened-prop\">opened</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#triggerSize-prop\">triggerSize</a></b></b> : real</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#close-method\">close</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#open-method\">open</a></b></b>()</li>\n</ul>\n<!-- $$$Panel-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Unless your application has very specific needs for a Panel, use a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> with the default toolbar.</p>\n<p>When using a Panel, do not theme it directly, but theme its contents, because the Panel itself should not have visible elements, since it is in the view (to detect mouse events) even when its contents should be invisible.</p>\n<p>Set the anchors and/or width/height of the Panel to specify the area that the Panel covers when opened.</p>\n<p>A black panel that can be swiped in from the lower-right of the window can be created like this:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">Item</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">width</span>: <span class=\"name\">parent</span>.<span class=\"name\">width</span> <span class=\"operator\">/</span> <span class=\"number\">2</span>\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\">Rectangle</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">overlay</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click&quot;</span>\n }\n }\n }\n}</pre>\n<p>A panel that looks like the standard (bottom-aligned) toolbar, but with custom contents, can be created like this:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">Item</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\">Item</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"comment\">// two properties used by the toolbar delegate:</span>\n property <span class=\"type\">bool</span> <span class=\"name\">opened</span>: <span class=\"name\">panel</span>.<span class=\"name\">opened</span>\n property <span class=\"type\">bool</span> <span class=\"name\">animating</span>: <span class=\"name\">panel</span>.<span class=\"name\">animating</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click&quot;</span>\n }\n }\n }\n}</pre>\n<p>Any Items can be placed inside the Panel, but MouseAreas can block mouse events from reaching the panel and thus obstruct the swiping behavior for hiding the panel. As a result, the user cannot start swiping on the buttons in the examples above in order to hide the panel. To remedy this, clicked() signals are forwarded from the panel to its children. The children's clicked() signal does not have a mouse parameter. Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">Rectangle</span> {\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">background</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\">Rectangle</span> {\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">overlay</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"type\">Rectangle</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">4</span>)\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">foreground</span>\n signal <span class=\"type\">clicked</span>()\n <span class=\"name\">onClicked</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;The red rectangle was clicked&quot;</span>);\n }\n }\n }\n}</pre>\n<p>Like this, the red rectangle accepts clicked() events, but the user can still swipe down on top of the rectangle in order to hide the panel.</p>\n<!-- @@@Panel -->\n<h2>Property Documentation</h2>\n<!-- $$$align -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"align-prop\"></a><span class=\"name\">align</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property defines the alignment of the panel. The implementation supports the following values:</p>\n<ul>\n<li>Qt.AlignBottom to swipe in the panel from the bottom (default)</li>\n<li>Qt.AlignTop to swipe in the panel from the top</li>\n<li>Qt.AlignLeft to swipe in the panel from the left</li>\n<li>Qt.AlignRight to swipe in the panel from the right</li>\n<li>Qt.AlignLeading left when layout mirrorring is disabled, right otherwise</li>\n<li>Qt.AlignTrailing right when layout mirroring is disabled, left otherwise</li>\n</ul>\n<p>The default value is <b>Qt.AlignBottom</b>, and it is not recommended to change the default value because the left, right and top edge are already used for system functions, while the bottom edge is reserved for app-specific functionality such as a default toolbar. The use of Qt.AlignLeading and Qt.AlignTrailing is preferred over Qt.AlignLeft and Qt.AlignRight in order to more easily support right-to-left user interfaces that use LayoutMirroring.</p>\n</div></div><!-- @@@align -->\n<br/>\n<!-- $$$animating -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"animating-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">animating</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The toolbar is currently not in a stable hidden or visible state.</p>\n</div></div><!-- @@@animating -->\n<br/>\n<!-- $$$contents -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contents-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">contents</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">Object</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Default property, holds the content which will be swiped in and out.</p>\n</div></div><!-- @@@contents -->\n<br/>\n<!-- $$$hintSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hintSize-prop\"></a><span class=\"name\">hintSize</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>How much of the panel to show when the user touches the panel's edge. This gives the user a hint that there is a panel hiding at that edge and invites him/her to swipe to show the panel completely. Default value: units.gu(2).</p>\n</div></div><!-- @@@hintSize -->\n<br/>\n<!-- $$$locked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"locked-prop\"></a><span class=\"name\">locked</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Disable edge swipe to open/close the panel. False by default.</p>\n</div></div><!-- @@@locked -->\n<br/>\n<!-- $$$opened -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"opened-prop\"></a><span class=\"name\">opened</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>When opened, the panel is visible, otherwise it is hidden. Use edge swipes to open/close the panel. The opened property is not updated until the swipe gesture is completed.</p>\n</div></div><!-- @@@opened -->\n<br/>\n<!-- $$$triggerSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"triggerSize-prop\"></a><span class=\"name\">triggerSize</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The size (height for top or bottom-aligned panels, width for left or right-aligned panels) of the mouse area used to detect edge swipes to open the panel, when the panel is not opened. Default value: units.gu(2).</p>\n</div></div><!-- @@@triggerSize -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$close -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"close-method\"></a>Panel::<span class=\"name\">close</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Close the panel</p>\n</div></div><!-- @@@close -->\n<br/>\n<!-- $$$open -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"open-method\"></a>Panel::<span class=\"name\">open</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Open the panel</p>\n</div></div><!-- @@@open -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/488/", "name": "Panel", "description": "A panel that can be swiped in and out from an edge of the window by the user. For most applications, it is highly recommended to use the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> instead which includes a toolbar at its bottom...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Panel", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Panel-brief -->\n<p>A panel that can be swiped in and out from an edge of the window by the user. For most applications, it is highly recommended to use the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> instead which includes a toolbar at its bottom that can be swiped in or out. <a href=\"#details\">More...</a></p>\n<!-- @@@Panel -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></p>\n<p>Inherited by Toolbar.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#align-prop\">align</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#animate-prop\">animate</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#animating-prop\">animating</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#contents-prop\">contents</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#hideTimeout-prop\">hideTimeout</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#hintSize-prop\">hintSize</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#locked-prop\">locked</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#opened-prop\">opened</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#position-prop\">position</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#triggerSize-prop\">triggerSize</a></b></b> : real</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#close-method\">close</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#open-method\">open</a></b></b>()</li>\n</ul>\n<!-- $$$Panel-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Unless your application has very specific needs for a Panel, use a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> with the default toolbar.</p>\n<p>When using a Panel, do not theme it directly, but theme its contents, because the Panel itself should not have visible elements, since it is in the view (to detect mouse events) even when its contents should be invisible.</p>\n<p>Set the anchors and/or width/height of the Panel to specify the area that the Panel covers when opened.</p>\n<p>A black panel that can be swiped in from the lower-right of the window can be created like this:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">width</span>: <span class=\"name\">parent</span>.<span class=\"name\">width</span> <span class=\"operator\">/</span> <span class=\"number\">2</span>\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">overlay</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click&quot;</span>\n }\n }\n }\n}</pre>\n<p>A panel that looks like the standard (bottom-aligned) toolbar, but with custom contents, can be created like this:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">80</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"comment\">// two properties used by the toolbar delegate:</span>\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span> <span class=\"name\">opened</span>: <span class=\"name\">panel</span>.<span class=\"name\">opened</span>\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span> <span class=\"name\">animating</span>: <span class=\"name\">panel</span>.<span class=\"name\">animating</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Click&quot;</span>\n }\n }\n }\n}</pre>\n<p>Any Items can be placed inside the Panel, but MouseAreas can block mouse events from reaching the panel and thus obstruct the swiping behavior for hiding the panel. As a result, the user cannot start swiping on the buttons in the examples above in order to hide the panel. To remedy this, clicked() signals are forwarded from the panel by calling the child's trigger() function. Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">background</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"type\">Panel</span> {\n <span class=\"name\">id</span>: <span class=\"name\">panel</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">color</span>: <span class=\"name\">Theme</span>.<span class=\"name\">palette</span>.<span class=\"name\">normal</span>.<span class=\"name\">overlay</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">8</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">4</span>)\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;red&quot;</span>\n <span class=\"keyword\">function</span> <span class=\"name\">trigger</span>() {\n <span class=\"name\">print</span>(<span class=\"string\">&quot;The red rectangle was clicked&quot;</span>);\n }\n }\n }\n }\n <span class=\"name\">Component</span>.onCompleted: <span class=\"name\">panel</span>.<span class=\"name\">open</span>();\n}</pre>\n<p>Like this, the red rectangle accepts click events, but the user can still swipe down on top of the rectangle in order to hide the panel.</p>\n<!-- @@@Panel -->\n<h2>Property Documentation</h2>\n<!-- $$$align -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"align-prop\"></a><span class=\"name\">align</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property defines the alignment of the panel. The implementation supports the following values:</p>\n<ul>\n<li>Qt.AlignBottom to swipe in the panel from the bottom (default)</li>\n<li>Qt.AlignTop to swipe in the panel from the top</li>\n<li>Qt.AlignLeft to swipe in the panel from the left</li>\n<li>Qt.AlignRight to swipe in the panel from the right</li>\n<li>Qt.AlignLeading left when layout mirrorring is disabled, right otherwise</li>\n<li>Qt.AlignTrailing right when layout mirroring is disabled, left otherwise</li>\n</ul>\n<p>The default value is <b>Qt.AlignBottom</b>, and it is not recommended to change the default value because the left, right and top edge are already used for system functions, while the bottom edge is reserved for app-specific functionality such as a default toolbar. The use of Qt.AlignLeading and Qt.AlignTrailing is preferred over Qt.AlignLeft and Qt.AlignRight in order to more easily support right-to-left user interfaces that use <a href=\"/api/qml/sdk-14.04/QtQuick.LayoutMirroring\">LayoutMirroring</a>.</p>\n</div></div><!-- @@@align -->\n<br/>\n<!-- $$$animate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"animate-prop\"></a><span class=\"name\">animate</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Animate transitions between the different panel states.</p>\n</div></div><!-- @@@animate -->\n<br/>\n<!-- $$$animating -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"animating-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">animating</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The toolbar is currently not in a stable hidden or visible state.</p>\n</div></div><!-- @@@animating -->\n<br/>\n<!-- $$$contents -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contents-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">contents</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\">Object</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Default property, holds the content which will be swiped in and out.</p>\n</div></div><!-- @@@contents -->\n<br/>\n<!-- $$$hideTimeout -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hideTimeout-prop\"></a><span class=\"name\">hideTimeout</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The time in milliseconds before the panel automatically hides after inactivity when it is not locked. Interacting with the panel resets the timer. Note that adding contents to the panel that accepts mouse events will prevent the panel from detecting interaction and the timer will not be reset. Setting a negative value will disable automatic hiding. Default value: -1 (automatic hiding is disabled).</p>\n</div></div><!-- @@@hideTimeout -->\n<br/>\n<!-- $$$hintSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hintSize-prop\"></a><span class=\"name\">hintSize</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>How much of the panel to show when the user touches the panel's edge. This gives the user a hint that there is a panel hiding at that edge and invites him/her to swipe to show the panel completely. Default value: units.gu(2).</p>\n</div></div><!-- @@@hintSize -->\n<br/>\n<!-- $$$locked -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"locked-prop\"></a><span class=\"name\">locked</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Disable edge swipe to open/close the panel. False by default.</p>\n</div></div><!-- @@@locked -->\n<br/>\n<!-- $$$opened -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"opened-prop\"></a><span class=\"name\">opened</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>When opened, the panel is visible, otherwise it is hidden. Use edge swipes to open/close the panel. The opened property is not updated until the swipe gesture is completed.</p>\n</div></div><!-- @@@opened -->\n<br/>\n<!-- $$$position -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"position-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">position</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The current position of the edge of the panel. The value is 0 when the panel is opened, and has its maximum value when the panel is closed. The maximum value is the width of the Panel for a left or right-aligned panel, and the height of the panel for top or bottom-aligned panels. When the user drags the Panel from the edge to open it, the position will change from the maximum size (closed) to 0 (fully expanded).</p>\n</div></div><!-- @@@position -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The user presses on the opened toolbar, or when the toolbar is closed but not locked, the user presses in the toolbar trigger area.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$triggerSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"triggerSize-prop\"></a><span class=\"name\">triggerSize</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The size (height for top or bottom-aligned panels, width for left or right-aligned panels) of the mouse area used to detect edge swipes to open the panel, when the panel is not opened. Default value: units.gu(2).</p>\n</div></div><!-- @@@triggerSize -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$close -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"close-method\"></a>Panel::<span class=\"name\">close</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Close the panel</p>\n</div></div><!-- @@@close -->\n<br/>\n<!-- $$$open -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"open-method\"></a>Panel::<span class=\"name\">open</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Open the panel</p>\n</div></div><!-- @@@open -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-panel.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/491/", "name": "PickerPanel", "description": "Provides a panel for opening a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a> in place of the input panel or as Popover, depending on the form factor. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.PickerPanel", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$PickerPanel-brief -->\n<p>Provides a panel for opening a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a> in place of the input panel or as Popover, depending on the form factor. <a href=\"#details\">More...</a></p>\n<!-- @@@PickerPanel -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQml.QtObject\">QtObject</a></p>\n<ul>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#openDatePicker-method\">openDatePicker</a></b></b>(<i>caller</i>, <i>property</i>, <i>mode</i>)</li>\n</ul>\n<!-- $$$PickerPanel-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>PickerPanel is a singleton component designed to open a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a> in the input panel area or in a Popover, depending on the form factor, following the design guides on date pickers.</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\">MainWindow</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">40</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">71</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;PickerPanel&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">dateButton</span>\n property <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-date.html\">date</a></span> <span class=\"name\">date</span>: new <span class=\"name\">Date</span>()\n <span class=\"name\">text</span>: <span class=\"name\">Qt</span>.<span class=\"name\">formatDateTime</span>(<span class=\"name\">date</span>, <span class=\"string\">&quot;yyyy/MMMM&quot;</span>)\n <span class=\"name\">onClicked</span>: <span class=\"name\">PickerPanel</span>.<span class=\"name\">openDatePicker</span>(<span class=\"name\">dateButton</span>, <span class=\"string\">&quot;date&quot;</span>, <span class=\"string\">&quot;Years|Months&quot;</span>)\n }\n }\n}</pre>\n<p>The opened panel is closed automatically when the user taps/presses outside of the panel or Popover area.</p>\n<!-- @@@PickerPanel -->\n<h2>Method Documentation</h2>\n<!-- $$$openDatePicker -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"openDatePicker-method\"></a>PickerPanel::<span class=\"name\">openDatePicker</span>(<i> caller</i>, <i> property</i>, <i> mode</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>The function opens a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a> component in the input method area or in a popover, depending on the availability of an input method provider in the system and whether the size of the main screen width/height defines a phone form factor. The picked date will be read from and reported to the <i>property</i> of the <i>caller</i> as date type. This implies that the caller must have defined the given property of type date.</p>\n<p>On failure, the function returns null. On success, the returned object has the following properties:</p>\n<pre class=\"cpp\">Object {\n property DatePicker picker\n property string pickerMode\n property date date\n property Item caller\n property string callerProperty\n signal closed()\n}</pre>\n<table class=\"generic\">\n <thead><tr class=\"qt-style\"><th >Property</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"odd\"><td ><b>picker</b></td><td >instance of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a> component shown in the panel/popup</td></tr>\n<tr valign=\"top\" class=\"even\"><td ><b>pickerMode</b></td><td >represents the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker#mode-prop\">DatePicker::mode</a> to be used. This is an optional parameter and if not defined, the default mode will be used.</td></tr>\n<tr valign=\"top\" class=\"odd\"><td ><b>date</b></td><td >represents the date selected</td></tr>\n<tr valign=\"top\" class=\"even\"><td ><b>caller</b></td><td >the instance of the component opening the panel</td></tr>\n<tr valign=\"top\" class=\"odd\"><td ><b>callerProperty</b></td><td >the property of the caller holding the date value which will be updated by the picker.</td></tr>\n<thead><tr class=\"qt-style\"><th >Signal</th><th >Description</th></tr></thead>\n<tr valign=\"top\" class=\"even\"><td >closed()</td><td >the signal is emitted when the panel or popover gets closed. The signal is handy when actions are performed upon panel close.</td></tr>\n</table>\n</div></div><!-- @@@openDatePicker -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-pickerpanel.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/494/", "name": "ProgressBar", "description": "The ProgressBar component visually indicates the progress of a process of determinate or indeterminate duration. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.ProgressBar", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ProgressBar-brief -->\n<p>The ProgressBar component visually indicates the progress of a process of determinate or indeterminate duration. <a href=\"#details\">More...</a></p>\n<!-- @@@ProgressBar -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#indeterminate-prop\">indeterminate</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#maximumValue-prop\">maximumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#minimumValue-prop\">minimumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#value-prop\">value</a></b></b> : real<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$ProgressBar-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">ProgressBar</span> {\n <span class=\"name\">id</span>: <span class=\"name\">indeterminateBar</span>\n <span class=\"name\">indeterminate</span>: <span class=\"number\">true</span>\n }\n <span class=\"type\">ProgressBar</span> {\n <span class=\"name\">id</span>: <span class=\"name\">determinateBar</span>\n <span class=\"name\">minimumValue</span>: -<span class=\"number\">3.0</span>\n <span class=\"name\">maximumValue</span>: <span class=\"number\">15</span>\n }\n}</pre>\n<!-- @@@ProgressBar -->\n<h2>Property Documentation</h2>\n<!-- $$$indeterminate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"indeterminate-prop\"></a><span class=\"name\">indeterminate</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies whether the progress interval is unknown. When set, altering other properties do not have any effect on the component's behavior. By default the property is set to false.</p>\n</div></div><!-- @@@indeterminate -->\n<br/>\n<!-- $$$maximumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumValue-prop\"></a><span class=\"name\">maximumValue</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the maximum value of the progress.</p>\n</div></div><!-- @@@maximumValue -->\n<br/>\n<!-- $$$minimumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"minimumValue-prop\"></a><span class=\"name\">minimumValue</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the minimum value of the progress.</p>\n</div></div><!-- @@@minimumValue -->\n<br/>\n<!-- $$$value -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"value-prop\"></a><span class=\"name\">value</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the current value of the progress</p>\n</div></div><!-- @@@value -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-progressbar.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/182/", "name": "ProgressBar", "description": "The ProgressBar component visually indicates the progress of a process of determinate or indeterminate duration. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.ProgressBar", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$ProgressBar-brief -->\n<p>The ProgressBar component visually indicates the progress of a process of determinate or indeterminate duration. <a href=\"#details\">More...</a></p>\n<!-- @@@ProgressBar -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#indeterminate-prop\">indeterminate</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#maximumValue-prop\">maximumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#minimumValue-prop\">minimumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#value-prop\">value</a></b></b> : real<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$ProgressBar-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">ProgressBar</span> {\n <span class=\"name\">id</span>: <span class=\"name\">indeterminateBar</span>\n <span class=\"name\">indeterminate</span>: <span class=\"number\">true</span>\n }\n <span class=\"type\">ProgressBar</span> {\n <span class=\"name\">id</span>: <span class=\"name\">determinateBar</span>\n <span class=\"name\">minimumValue</span>: -<span class=\"number\">3.0</span>\n <span class=\"name\">maximumValue</span>: <span class=\"number\">15</span>\n }\n}</pre>\n<!-- @@@ProgressBar -->\n<h2>Property Documentation</h2>\n<!-- $$$indeterminate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"indeterminate-prop\"></a><span class=\"name\">indeterminate</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies whether the progress interval is unknown. When set, altering other properties do not have any effect on the component's behavior. By default the property is set to false.</p>\n</div></div><!-- @@@indeterminate -->\n<br/>\n<!-- $$$maximumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumValue-prop\"></a><span class=\"name\">maximumValue</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the maximum value of the progress.</p>\n</div></div><!-- @@@maximumValue -->\n<br/>\n<!-- $$$minimumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"minimumValue-prop\"></a><span class=\"name\">minimumValue</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the minimum value of the progress.</p>\n</div></div><!-- @@@minimumValue -->\n<br/>\n<!-- $$$value -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"value-prop\"></a><span class=\"name\">value</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Specifies the current value of the progress</p>\n</div></div><!-- @@@value -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/495/", "name": "Scrollbar", "description": "The ScrollBar component provides scrolling functionality for scrollable views (i.e&#x2e; Flickable, <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a>). ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Scrollbar", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Scrollbar-brief -->\n<p>The ScrollBar component provides scrolling functionality for scrollable views (i.e&#x2e; Flickable, <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a>). <a href=\"#details\">More...</a></p>\n<!-- @@@Scrollbar -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#align-prop\">align</a></b></b> : int<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#flickableItem-prop\">flickableItem</a></b></b> : Flickable<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n</ul>\n<!-- $$$Scrollbar-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The ScrollBar can be set to any flickable and has built-in anchoring setup to the attached flickable's front, rear, top or bottom. the scrollbar can also be aligned using anchors, however the built-in align functionality makes sure to have the proper alignemt applied based on theme and layout direction (RTL or LTR).</p>\n<p>The content position is driven through the attached Flickable. Therefore every style implementation should drive the position through contentX/contentY properties, depending on whether the orientation is vertical or horizontal.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">list</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">37</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">37</span>)\n <span class=\"name\">model</span>: <span class=\"number\">30</span>\n <span class=\"name\">delegate</span>: <span class=\"name\">Rectangle</span> {\n <span class=\"name\">width</span>: <span class=\"name\">ListView</span>.<span class=\"name\">view</span>.<span class=\"name\">width</span>\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Text\">Text</a></span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Item &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">modelData</span>\n }\n }\n }\n <span class=\"type\">Scrollbar</span> {\n <span class=\"name\">flickableItem</span>: <span class=\"name\">list</span>\n <span class=\"name\">align</span>: <span class=\"name\">Qt</span>.<span class=\"name\">AlignTrailing</span>\n }\n}</pre>\n<!-- @@@Scrollbar -->\n<h2>Property Documentation</h2>\n<!-- $$$align -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"align-prop\"></a><span class=\"name\">align</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property defines the alignment of the scrollbar to the <a href=\"#flickableItem-prop\">flickableItem</a>. The implementation handles the alignment as follows:</p>\n<ul>\n<li>Qt.AlignLeading anchors to the left on LTR and to the right on RTL layouts</li>\n<li>Qt.AlignTrailing anchors to the right on LTR and to the left on RTL layouts</li>\n<li>Qt.AlignTop anchors to the top</li>\n<li>Qt.AlignBottom anchors to the bottom</li>\n</ul>\n<p>The default value is <b>Qt.AlignTrailing</b>.</p>\n</div></div><!-- @@@align -->\n<br/>\n<!-- $$$flickableItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"flickableItem-prop\"></a><span class=\"name\">flickableItem</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Flickable\">Flickable</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>This property holds the flickable item (Flickable, <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a> or <a href=\"/api/qml/sdk-14.04/QtQuick.GridView\">GridView</a>) the Scrollbar is attached to.</p>\n</div></div><!-- @@@flickableItem -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-scrollbar.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/183/", "name": "Scrollbar", "description": "The ScrollBar component provides scrolling functionality for scrollable views (i.e&#x2e; Flickable, ListView). ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Scrollbar", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Scrollbar-brief -->\n<p>The ScrollBar component provides scrolling functionality for scrollable views (i.e&#x2e; Flickable, ListView). <a href=\"#details\">More...</a></p>\n<!-- @@@Scrollbar -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#align-prop\">align</a></b></b> : int<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#flickableItem-prop\">flickableItem</a></b></b> : Flickable<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n</ul>\n<!-- $$$Scrollbar-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The ScrollBar can be set to any flickable and has built-in anchoring setup to the attached flickable's front, rear, top or bottom. the scrollbar can also be aligned using anchors, however the built-in align functionality makes sure to have the proper alignemt applied based on theme and layout direction (RTL or LTR).</p>\n<p>The content position is driven through the attached Flickable. Therefore every style implementation should drive the position through contentX/contentY properties, depending on whether the orientation is vertical or horizontal.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">ListView</span> {\n <span class=\"name\">id</span>: <span class=\"name\">list</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">37</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">37</span>)\n <span class=\"name\">model</span>: <span class=\"number\">30</span>\n <span class=\"name\">delegate</span>: <span class=\"name\">Rectangle</span> {\n <span class=\"name\">width</span>: <span class=\"name\">ListView</span>.<span class=\"name\">view</span>.<span class=\"name\">width</span>\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">5</span>)\n <span class=\"type\">Text</span> {\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Item &quot;</span> <span class=\"operator\">+</span> <span class=\"name\">modelData</span>\n }\n }\n }\n <span class=\"type\">Scrollbar</span> {\n <span class=\"name\">flickableItem</span>: <span class=\"name\">list</span>\n <span class=\"name\">align</span>: <span class=\"name\">Qt</span>.<span class=\"name\">AlignTrailing</span>\n }\n}</pre>\n<!-- @@@Scrollbar -->\n<h2>Property Documentation</h2>\n<!-- $$$align -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"align-prop\"></a><span class=\"name\">align</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The property defines the alignment of the scrollbar to the <a href=\"#flickableItem-prop\">flickableItem</a>. The implementation handles the alignment as follows:</p>\n<ul>\n<li>Qt.AlignLeading anchors to the left on LTR and to the right on RTL layouts</li>\n<li>Qt.AlignTrailing anchors to the right on LTR and to the left on RTL layouts</li>\n<li>Qt.AlignTop anchors to the top</li>\n<li>Qt.AlignBottom anchors to the bottom</li>\n</ul>\n<p>The default value is <b>Qt.AlignTrailing</b>.</p>\n</div></div><!-- @@@align -->\n<br/>\n<!-- $$$flickableItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"flickableItem-prop\"></a><span class=\"name\">flickableItem</span> : <span class=\"type\">Flickable</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>This property holds the flickable item (Flickable, ListView or GridView) the Scrollbar is attached to.</p>\n</div></div><!-- @@@flickableItem -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/499/", "name": "Slider", "description": "Slider is a component to select a value from a continuous range of values. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Slider", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Slider-brief -->\n<p>Slider is a component to select a value from a continuous range of values. <a href=\"#details\">More...</a></p>\n<!-- @@@Slider -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#live-prop\">live</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#maximumValue-prop\">maximumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#minimumValue-prop\">minimumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#value-prop\">value</a></b></b> : real<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#touched-signal\">touched</a></b></b>(bool <i>onThumb</i>)<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#formatValue-method\">formatValue</a></b></b>(<i>v</i>)<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$Slider-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The slider's sensing area is defined by the width and height, therefore styles should take this into account when defining the visuals, and alter these values to align the graphics' sizes.</p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/slider\">See also the Design Guidelines on Sliders</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">Slider</span> {\n <span class=\"keyword\">function</span> <span class=\"name\">formatValue</span>(<span class=\"name\">v</span>) { <span class=\"keyword\">return</span> <span class=\"name\">v</span>.<span class=\"name\">toFixed</span>(<span class=\"number\">2</span>) }\n <span class=\"name\">minimumValue</span>: -<span class=\"number\">3.14</span>\n <span class=\"name\">maximumValue</span>: <span class=\"number\">3.14</span>\n <span class=\"name\">value</span>: <span class=\"number\">0.0</span>\n <span class=\"name\">live</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@Slider -->\n<h2>Property Documentation</h2>\n<!-- $$$live -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"live-prop\"></a><span class=\"name\">live</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Defines whether the value is updated while the thumb is dragged or just when the thumb is released.</p>\n</div></div><!-- @@@live -->\n<br/>\n<!-- $$$maximumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumValue-prop\"></a><span class=\"name\">maximumValue</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The maximum value from the continuous range of values. If this value is lesser than <a href=\"#minimumValue-prop\">minimumValue</a>, the component will be in an inconsistent state.</p>\n</div></div><!-- @@@maximumValue -->\n<br/>\n<!-- $$$minimumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"minimumValue-prop\"></a><span class=\"name\">minimumValue</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The minimum value from the continuous range of values. If this value is greater than <a href=\"#maximumValue-prop\">maximumValue</a>, the component will be in an inconsistent state.</p>\n</div></div><!-- @@@minimumValue -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Whether the Slider is currently being pressed.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$value -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"value-prop\"></a><span class=\"name\">value</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The current value of the slider. This property is not changed while the thumb is dragged unless the live property is set to true.</p>\n</div></div><!-- @@@value -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$touched -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"touched-signal\"></a>Slider::<span class=\"name\">touched</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span><i> onThumb</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The signal is emitted when there is a click on the slider. The onThumb parameter provides information if the click, was inside of the thumb element.</p>\n</div></div><!-- @@@touched -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$formatValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"formatValue-method\"></a>Slider::<span class=\"name\">formatValue</span>(<i> v</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>This function is used by the value indicator to show the current value. Reimplement this function if you want to show different information. By default, the value v is rounded to the nearest interger value.</p>\n</div></div><!-- @@@formatValue -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-slider.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/187/", "name": "Slider", "description": "Slider is a component to select a value from a continuous range of values. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Slider", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Slider-brief -->\n<p>Slider is a component to select a value from a continuous range of values. <a href=\"#details\">More...</a></p>\n<!-- @@@Slider -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#live-prop\">live</a></b></b> : bool<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#maximumValue-prop\">maximumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#minimumValue-prop\">minimumValue</a></b></b> : real<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#value-prop\">value</a></b></b> : real<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#touched-signal\">touched</a></b></b>(bool <i>onThumb</i>)<tt> (preliminary)</tt></li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#formatValue-method\">formatValue</a></b></b>(<i>v</i>)<tt> (preliminary)</tt></li>\n</ul>\n<!-- $$$Slider-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The slider's sensing area is defined by the width and height, therefore styles should take this into account when defining the visuals, and alter these values to align the graphics' sizes.</p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/slider\">See also the Design Guidelines on Sliders</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">Slider</span> {\n <span class=\"keyword\">function</span> <span class=\"name\">formatValue</span>(<span class=\"name\">v</span>) { <span class=\"keyword\">return</span> <span class=\"name\">v</span>.<span class=\"name\">toFixed</span>(<span class=\"number\">2</span>) }\n <span class=\"name\">minimumValue</span>: -<span class=\"number\">3.14</span>\n <span class=\"name\">maximumValue</span>: <span class=\"number\">3.14</span>\n <span class=\"name\">value</span>: <span class=\"number\">0.0</span>\n <span class=\"name\">live</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@Slider -->\n<h2>Property Documentation</h2>\n<!-- $$$live -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"live-prop\"></a><span class=\"name\">live</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Defines whether the value is updated while the thumb is dragged or just when the thumb is released.</p>\n</div></div><!-- @@@live -->\n<br/>\n<!-- $$$maximumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumValue-prop\"></a><span class=\"name\">maximumValue</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The maximum value from the continuous range of values. If this value is lesser than <a href=\"#minimumValue-prop\">minimumValue</a>, the component will be in an inconsistent state.</p>\n</div></div><!-- @@@maximumValue -->\n<br/>\n<!-- $$$minimumValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"minimumValue-prop\"></a><span class=\"name\">minimumValue</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The minimum value from the continuous range of values. If this value is greater than <a href=\"#maximumValue-prop\">maximumValue</a>, the component will be in an inconsistent state.</p>\n</div></div><!-- @@@minimumValue -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"name\">pressed</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Whether the Slider is currently being pressed.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$value -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"value-prop\"></a><span class=\"name\">value</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The current value of the slider. This property is not changed while the thumb is dragged unless the live property is set to true.</p>\n</div></div><!-- @@@value -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$touched -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"touched-signal\"></a>Slider::<span class=\"name\">touched</span>(<span class=\"type\">bool</span><i> onThumb</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The signal is emitted when there is a click on the slider. The onThumb parameter provides information if the click, was inside of the thumb element.</p>\n</div></div><!-- @@@touched -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$formatValue -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"formatValue-method\"></a>Slider::<span class=\"name\">formatValue</span>(<i> v</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>This function is used by the value indicator to show the current value. Reimplement this function if you want to show different information. By default, the value v is rounded to the nearest interger value.</p>\n</div></div><!-- @@@formatValue -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/526/", "name": "StateSaver", "description": "Attached propertyes to save component property states. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.StateSaver", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$StateSaver-brief -->\n<p>Attached propertyes to save component property states. <a href=\"#details\">More...</a></p>\n<!-- @@@StateSaver -->\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#enabled-prop\">enabled</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#properties-prop\">properties</a></b></b> : string</li>\n</ul>\n<!-- $$$StateSaver-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>StateSaver attached object provides the ability to save component property values that can be restored after an inproper application close. The properties subject of serialization must be given in the <a href=\"#properties-prop\">properties</a> as a string, separated with commas. The serialization will happen automatically on component's completion time, as well as when the application is deactivated. Automatic serialization of a component can be turned off by simply setting false to <a href=\"#enabled-prop\">enabled</a> property.</p>\n<p>States saved are discarded when the application is closed properly. The state loading is ignored (but not discarded) when the application is launched through <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.UriHandler\">UriHandler</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">input</span>\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;text&quot;</span>\n <span class=\"name\">StateSaver</span>.enabled: <span class=\"name\">input</span>.<span class=\"name\">enabled</span>\n}</pre>\n<p>In this example the state saver is synchronized with the attachee's one.</p>\n<p>Group properties can also be serialized by specifying the path to their individual properties.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">rect</span>\n <span class=\"name\">color</span>: <span class=\"string\">&quot;gray&quot;</span>\n <span class=\"type\">border</span> {\n <span class=\"name\">color</span>: <span class=\"string\">&quot;blue&quot;</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">1</span>)\n }\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;color, border.color, border.width&quot;</span>\n}</pre>\n<p>StateSaver computes a unique identifier for the attachee using the component's and all its parents' <i>id</i>. Therefore attachee component as well as all its parents must have a valid ID set.</p>\n<p>The following example will give error for the <i>input</i>, as the root component has no id specified:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"comment\">//[...]</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">parent</span>\n <span class=\"comment\">//[...]</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">input</span>\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;text&quot;</span>\n }\n }\n}</pre>\n<p>but the following example will successfully save the text field content</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">root</span>\n <span class=\"comment\">//[...]</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">parent</span>\n <span class=\"comment\">//[...]</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">input</span>\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;text&quot;</span>\n }\n }\n}</pre>\n<p>When used with Repeater, each created item from the Repeater's delegate will be saved separately. Note that due to the way Repeater works, Repeaters do not need to have id specified.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">root</span>\n <span class=\"comment\">// [...]</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Repeater\">Repeater</a></span> {\n <span class=\"name\">model</span>: <span class=\"number\">10</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Rectangle\">Rectangle</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">rect</span>\n <span class=\"name\">width</span>: <span class=\"number\">50</span>; <span class=\"name\">height</span>: <span class=\"number\">50</span>\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;width, height&quot;</span>\n }\n }\n <span class=\"comment\">// [...]</span>\n}</pre>\n<p>It can be used in the same way in <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a> or <a href=\"/api/qml/sdk-14.04/QtQuick.GridView\">GridView</a>, except that both <a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a> and <a href=\"/api/qml/sdk-14.04/QtQuick.GridView\">GridView</a> must have an id set.</p>\n<p>The StateSaver can save all <a href=\"/api/qml/sdk-14.04/QtQml.qtqml-typesystem-basictypes\">QML base types</a>, Objects, list of objects or variants containing any of these cannot be saved.</p>\n<!-- @@@StateSaver -->\n<h2>Property Documentation</h2>\n<!-- $$$enabled -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"enabled-prop\"></a><span class=\"name\">enabled</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property drives the automatic state saving. When disabled, state saving will not happen on properties.</p>\n<p>The default value is true.</p>\n</div></div><!-- @@@enabled -->\n<br/>\n<!-- $$$properties -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"properties-prop\"></a><span class=\"name\">properties</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>List of properties to be serialized, separated with commas. Properties must be writable and can only be <a href=\"/api/qml/sdk-14.04/QtQml.qtqml-typesystem-basictypes\">QML base types</a>.</p>\n<p>A custom singl eline input which saves the text, polaceholderText, font and color would look as follows:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">input</span>\n <span class=\"name\">StateSaver</span>.properties: <span class=\"string\">&quot;text, placeholderText, font, color&quot;</span>\n}</pre>\n</div></div><!-- @@@properties -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-statesaver.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/189/", "name": "StyledItem", "description": "The StyledItem class allows items to be styled by the theme. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.StyledItem", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$StyledItem-brief -->\n<p>The StyledItem class allows items to be styled by the theme. <a href=\"#details\">More...</a></p>\n<!-- @@@StyledItem -->\n<p>Inherited by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ActionItem/\">ActionItem</a>, Header, PageTreeNode, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Pickers.Picker/\">Picker</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Scrollbar/\">Scrollbar</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Slider/\">Slider</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TabBar/\">TabBar</a>, <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>, and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n</ul>\n<!-- $$$StyledItem-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>StyledItem provides facilities for making an Item stylable by the theme.</p>\n<p>In order to make an Item stylable by the theme, it is enough to make the Item inherit from StyledItem and set its <a href=\"#style-prop\">style</a> property to be the result of the appropriate call to Theme.createStyleComponent().</p>\n<p>Example definition of a custom Item MyItem.qml:</p>\n<pre class=\"qml\"><span class=\"type\">StyledItem</span> {\n <span class=\"name\">id</span>: <span class=\"name\">myItem</span>\n <span class=\"name\">style</span>: <span class=\"name\">Theme</span>.<span class=\"name\">createStyleComponent</span>(<span class=\"string\">&quot;MyItemStyle.qml&quot;</span>, <span class=\"name\">myItem</span>)\n}</pre>\n<p>The Component set on <a href=\"#style-prop\">style</a> is instantiated and placed below everything else that the Item contains.</p>\n<p>A reference to the Item being styled is accessible from the style and named 'styledItem'.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Theme/\">Theme</a>.</p>\n<!-- @@@StyledItem -->\n<h2>Property Documentation</h2>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/501/", "name": "StyledItem", "description": "The StyledItem class allows items to be styled by the theme. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.StyledItem", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$StyledItem-brief -->\n<p>The StyledItem class allows items to be styled by the theme. <a href=\"#details\">More...</a></p>\n<!-- @@@StyledItem -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/QtQuick.FocusScope\">FocusScope</a></p>\n<p>Inherited by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DatePicker\">DatePicker</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.Dialer\">Dialer</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.DialerHand\">DialerHand</a>, Header, PageTreeNode, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Pickers.Picker\">Picker</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Scrollbar\">Scrollbar</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Slider\">Slider</a>, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TabBar\">TabBar</a>, and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a>.</p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n</ul>\n<!-- $$$StyledItem-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>StyledItem provides facilities for making an Item stylable by the theme.</p>\n<p>In order to make an Item stylable by the theme, it is enough to make the Item inherit from StyledItem and set its <a href=\"#style-prop\">style</a> property to be the result of the appropriate call to Theme.createStyleComponent().</p>\n<p>Example definition of a custom Item MyItem.qml:</p>\n<pre class=\"qml\"><span class=\"type\">StyledItem</span> {\n <span class=\"name\">id</span>: <span class=\"name\">myItem</span>\n <span class=\"name\">style</span>: <span class=\"name\">Theme</span>.<span class=\"name\">createStyleComponent</span>(<span class=\"string\">&quot;MyItemStyle.qml&quot;</span>, <span class=\"name\">myItem</span>)\n}</pre>\n<p>The Component set on <a href=\"#style-prop\">style</a> is instantiated and placed below everything else that the Item contains.</p>\n<p>A reference to the Item being styled is accessible from the style and named 'styledItem'.</p>\n<p><b>See also </b><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Theme\">Theme</a>.</p>\n<!-- @@@StyledItem -->\n<h2>Property Documentation</h2>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-styleditem.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/503/", "name": "Switch", "description": "Switch is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.CheckBox\">CheckBox</a>, the only difference is the graphical style. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Switch", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Switch-brief -->\n<p>Switch is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.CheckBox\">CheckBox</a>, the only difference is the graphical style. <a href=\"#details\">More...</a></p>\n<!-- @@@Switch -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.CheckBox\">CheckBox</a></p>\n<ul>\n</ul>\n<!-- $$$Switch-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/toggles\">See also the Design Guidelines on Toggles</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@Switch -->\n</div></div>\n", "source_file": "qml-ubuntu-components0-switch.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/191/", "name": "Switch", "description": "Switch is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.CheckBox/\">CheckBox</a>, the only difference is the graphical style. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Switch", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Switch-brief -->\n<p>Switch is a component with two states, checked or unchecked. It can be used to set boolean options. The behavior is the same as <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.CheckBox/\">CheckBox</a>, the only difference is the graphical style. <a href=\"#details\">More...</a></p>\n<!-- @@@Switch -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.CheckBox/\">CheckBox</a></p>\n<ul>\n</ul>\n<!-- $$$Switch-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/toggles\">See also the Design Guidelines on Toggles</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">Switch</span> {\n <span class=\"name\">checked</span>: <span class=\"number\">true</span>\n }\n}</pre>\n<!-- @@@Switch -->\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/504/", "name": "Tab", "description": "Component to represent a single tab in a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> environment. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Tab", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Tab-brief -->\n<p>Component to represent a single tab in a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> environment. <a href=\"#details\">More...</a></p>\n<!-- @@@Tab -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url<tt> (deprecated)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#index-prop\">index</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#page-prop\">page</a></b></b> : Item</li>\n<li class=\"fn\"><b><b><a href=\"#title-prop\">title</a></b></b> : string</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onPageChanged-signal-handler\">onPageChanged</a></b></b>()</li>\n</ul>\n<!-- $$$Tab-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Examples: See <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a>.</p>\n<!-- @@@Tab -->\n<h2>Property Documentation</h2>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>The location of the icon that is displayed inside the button used to select this tab (optional). Either <a href=\"#title-prop\">title</a> or iconSource, or both must be defined. Deprecated because our new tab buttons in the header do not display an icon.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$index -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"index-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">index</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the index of the tab within the Tabs.</p>\n</div></div><!-- @@@index -->\n<br/>\n<!-- $$$page -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"page-prop\"></a><span class=\"name\">page</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The contents of the page. Use a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> or a Loader that loads an external <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a>.</p>\n</div></div><!-- @@@page -->\n<br/>\n<!-- $$$title -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"title-prop\"></a><span class=\"name\">title</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title that is shown on the tab button used to select this tab.</p>\n</div></div><!-- @@@title -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onPageChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onPageChanged-signal-handler\"></a>Tab::<span class=\"name\">onPageChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>When page is updated, set its parent to be tab.</p>\n</div></div><!-- @@@onPageChanged -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-tab.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/192/", "name": "Tab", "description": "Component to represent a single tab in a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> environment. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Tab", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Tab-brief -->\n<p>Component to represent a single tab in a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> environment. <a href=\"#details\">More...</a></p>\n<!-- @@@Tab -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#page-prop\">page</a></b></b> : Item</li>\n<li class=\"fn\"><b><b><a href=\"#title-prop\">title</a></b></b> : string</li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onPageChanged-signal-handler\">onPageChanged</a></b></b>()</li>\n</ul>\n<!-- $$$Tab-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Examples: See <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a>.</p>\n<!-- @@@Tab -->\n<h2>Property Documentation</h2>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The location of the icon that is displayed inside the button used to select this tab (optional). Either <a href=\"#title-prop\">title</a> or iconSource, or both must be defined. Deprecated because our new tab buttons in the header do not display an icon.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$page -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"page-prop\"></a><span class=\"name\">page</span> : <span class=\"type\">Item</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The contents of the page. Use a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> or a Loader that loads an external <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a>.</p>\n</div></div><!-- @@@page -->\n<br/>\n<!-- $$$title -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"title-prop\"></a><span class=\"name\">title</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The title that is shown on the tab button used to select this tab.</p>\n</div></div><!-- @@@title -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onPageChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onPageChanged-signal-handler\"></a>Tab::<span class=\"name\">onPageChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>When page is updated, set its parent to be tab.</p>\n</div></div><!-- @@@onPageChanged -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/505/", "name": "TabBar", "description": "Tab bar that will be shown in the header when <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> is active. This component does not need to be instantiated by the developer, it is automatically created by the <a href=\"/api/qml/sdk-14.04/Ubunt...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.TabBar", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$TabBar-brief -->\n<p>Tab bar that will be shown in the header when <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> is active. This component does not need to be instantiated by the developer, it is automatically created by the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a>. <a href=\"#details\">More...</a></p>\n<!-- @@@TabBar -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#alwaysSelectionMode-prop\">alwaysSelectionMode</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#animate-prop\">animate</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#model-prop\">model</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#pressed-prop\">pressed</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#selectedIndex-prop\">selectedIndex</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#selectionMode-prop\">selectionMode</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#tabsItem-prop\">tabsItem</a></b></b> : Item<tt> (deprecated)</tt></li>\n</ul>\n<a name=\"signal-handlers\"></a>\n<h2>Signal Handlers</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#onAlwaysSelectionModeChanged-signal-handler\">onAlwaysSelectionModeChanged</a></b></b>()</li>\n</ul>\n<!-- $$$TabBar-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<!-- @@@TabBar -->\n<h2>Property Documentation</h2>\n<!-- $$$alwaysSelectionMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"alwaysSelectionMode-prop\"></a><span class=\"name\">alwaysSelectionMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Do not deactivate the tab bar after a specified idle time or when the user selects a new tab. Off by default.</p>\n</div></div><!-- @@@alwaysSelectionMode -->\n<br/>\n<!-- $$$animate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"animate-prop\"></a><span class=\"name\">animate</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Show animations when the state changes. Default: true.</p>\n</div></div><!-- @@@animate -->\n<br/>\n<!-- $$$model -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"model-prop\"></a><span class=\"name\">model</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The model containing the tabs to be controlled by the TabBar. The tabs are visualized by the style, displaying controlling elements based on the data specified by the roles. The default style mandates the existence of either the <b>title</b> or <b>tab</b> role, but different styles may require to have other roles (e.g&#x2e; image, color). The order the role existence is checked is also determined by the style component, Default style checks the existence of the <b>tab</b> role first, and if not defined will use the <b>title</b> role.</p>\n</div></div><!-- @@@model -->\n<br/>\n<!-- $$$pressed -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"pressed-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">pressed</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The user is interacting with the tab bar. Depends on the style pressed property.</p>\n</div></div><!-- @@@pressed -->\n<br/>\n<!-- $$$selectedIndex -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedIndex-prop\"></a><span class=\"name\">selectedIndex</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the index of the selected Tab item.</p>\n</div></div><!-- @@@selectedIndex -->\n<br/>\n<!-- $$$selectionMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionMode-prop\"></a><span class=\"name\">selectionMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>An inactive tab bar only displays the currently selected tab, and an active tab bar can be interacted with to select a tab.</p>\n</div></div><!-- @@@selectionMode -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$tabsItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabsItem-prop\"></a><span class=\"name\">tabsItem</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> item that tab bar belongs to. Will be automatically set by <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tabs\">Tabs</a> when the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TabBar\">TabBar</a> is created.</p>\n</div></div><!-- @@@tabsItem -->\n<br/>\n<h2>Signal Handler Documentation</h2>\n<!-- $$$onAlwaysSelectionModeChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onAlwaysSelectionModeChanged-signal-handler\"></a>TabBar::<span class=\"name\">onAlwaysSelectionModeChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Automatically activate the tab bar when <a href=\"#alwaysSelectionMode-prop\">alwaysSelectionMode</a> is set.</p>\n</div></div><!-- @@@onAlwaysSelectionModeChanged -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-tabbar.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/193/", "name": "TabBar", "description": "Tab bar that will be shown in the header when <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> is active. This component does not need to be instantiated by the developer, it is automatically created by the...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.TabBar", "keywords": "", "data": "<span class=\"subtitle\"></span>\r\n<!-- $$$TabBar-brief -->\r\n<p>Tab bar that will be shown in the header when <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> is active. This component does not need to be instantiated by the developer, it is automatically created by the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a>. <a href=\"#details\">More...</a></p>\r\n<!-- @@@TabBar -->\r\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\r\n<ul>\r\n</ul>\r\n<a name=\"properties\"></a>\r\n<h2>Properties</h2>\r\n<ul>\r\n<li class=\"fn\"><b><b><a href=\"#alwaysSelectionMode-prop\">alwaysSelectionMode</a></b></b> : bool</li>\r\n<li class=\"fn\"><b><b><a href=\"#animate-prop\">animate</a></b></b> : bool</li>\r\n<li class=\"fn\"><b><b><a href=\"#selectionMode-prop\">selectionMode</a></b></b> : bool</li>\r\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\r\n<li class=\"fn\"><b><b><a href=\"#tabsItem-prop\">tabsItem</a></b></b> : Item</li>\r\n</ul>\r\n<a name=\"signal-handlers\"></a>\r\n<h2>Signal Handlers</h2>\r\n<ul>\r\n<li class=\"fn\"><b><b><a href=\"#onAlwaysSelectionModeChanged-signal-handler\">onAlwaysSelectionModeChanged</a></b></b>()</li>\r\n</ul>\r\n<!-- $$$TabBar-description -->\r\n<a name=\"details\"></a>\r\n<h2>Detailed Description</h2>\r\n<!-- @@@TabBar -->\r\n<h2>Property Documentation</h2>\r\n<!-- $$$alwaysSelectionMode -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"alwaysSelectionMode-prop\"></a><span class=\"name\">alwaysSelectionMode</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Do not deactivate the tab bar after a specified idle time or when the user selects a new tab. Off by default.</p>\r\n</div></div><!-- @@@alwaysSelectionMode -->\r\n<br/>\r\n<!-- $$$animate -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"animate-prop\"></a><span class=\"name\">animate</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Show animations when the state changes. Default: true.</p>\r\n</div></div><!-- @@@animate -->\r\n<br/>\r\n<!-- $$$selectionMode -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionMode-prop\"></a><span class=\"name\">selectionMode</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>An inactive tab bar only displays the currently selected tab, and an active tab bar can be interacted with to select a tab.</p>\r\n</div></div><!-- @@@selectionMode -->\r\n<br/>\r\n<!-- $$$style -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\r\n</div></div><!-- @@@style -->\r\n<br/>\r\n<!-- $$$tabsItem -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabsItem-prop\"></a><span class=\"name\">tabsItem</span> : <span class=\"type\">Item</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> item that tab bar belongs to. Will be automatically set by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tabs/\">Tabs</a> when the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TabBar/\">TabBar</a> is created.</p>\r\n</div></div><!-- @@@tabsItem -->\r\n<br/>\r\n<h2>Signal Handler Documentation</h2>\r\n<!-- $$$onAlwaysSelectionModeChanged -->\r\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"onAlwaysSelectionModeChanged-signal-handler\"></a>TabBar::<span class=\"name\">onAlwaysSelectionModeChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Automatically activate the tab bar when <a href=\"#alwaysSelectionMode-prop\">alwaysSelectionMode</a> is set.</p>\r\n</div></div><!-- @@@onAlwaysSelectionModeChanged -->\r\n<br/>\r\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/194/", "name": "Tabs", "description": "The Tabs class provides an environment where multible <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a> children can be added, and the user is presented with a tab bar with tab buttons to select different tab pages. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.Tabs", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Tabs-brief -->\n<p>The Tabs class provides an environment where multible <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a> children can be added, and the user is presented with a tab bar with tab buttons to select different tab pages. <a href=\"#details\">More...</a></p>\n<!-- @@@Tabs -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#currentPage-prop\">currentPage</a></b></b> : Item</li>\n<li class=\"fn\"><b><b><a href=\"#selectedTab-prop\">selectedTab</a></b></b> : Tab<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#selectedTabIndex-prop\">selectedTabIndex</a></b></b> : int<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#tabBar-prop\">tabBar</a></b></b> : TabBar</li>\n<li class=\"fn\"><b><b><a href=\"#tabChildren-prop\">tabChildren</a></b></b> : list&lt;Item&gt;</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#modelChanged-signal\">modelChanged</a></b></b>()</li>\n</ul>\n<!-- $$$Tabs-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Tabs must be placed inside a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a> so that it will automatically have a header that shows the tabs that can be selected, and the toolbar which contains the tools of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> in the currently selected <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a>.</p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/tabs\">See also the Design Guidelines on Tabs</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1 as ListItem\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">Tabs</span> {\n <span class=\"name\">id</span>: <span class=\"name\">tabs</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Simple page&quot;</span>)\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">label</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;A centered label&quot;</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.ToolbarButton/\">ToolbarButton</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;action&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;action triggered&quot;</span>)\n }\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">externalTab</span>\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;External&quot;</span>)\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;call_icon.png&quot;</span>\n <span class=\"name\">page</span>: <span class=\"name\">Loader</span> {\n <span class=\"name\">parent</span>: <span class=\"name\">externalTab</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">source</span>: (<span class=\"name\">tabs</span>.<span class=\"name\">selectedTab</span> <span class=\"operator\">===</span> <span class=\"name\">externalTab</span>) ? <span class=\"name\">Qt</span>.<span class=\"name\">resolvedUrl</span>(<span class=\"string\">&quot;MyCustomPage.qml&quot;</span>) : <span class=\"string\">&quot;&quot;</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;List view&quot;</span>)\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\">ListView</span> {\n <span class=\"name\">clip</span>: <span class=\"number\">true</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">model</span>: <span class=\"number\">20</span>\n <span class=\"name\">delegate</span>: <span class=\"name\">ListItem</span>.Standard {\n <span class=\"name\">icon</span>: <span class=\"name\">Qt</span>.<span class=\"name\">resolvedUrl</span>(<span class=\"string\">&quot;avatar_contacts_list.png&quot;</span>)\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Item &quot;</span><span class=\"operator\">+</span><span class=\"name\">modelData</span>\n }\n }\n }\n }\n }\n}</pre>\n<p>As the example above shows, an external <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a> inside a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a> can be loaded using a Loader.</p>\n<p>It is possible to use a Repeater to generate tabs, but when doing so, ensure that the Repeater is declared inside the Tabs at the end, because otherwise the shuffling of the order of children by the Repeater can cause incorrect ordering of the tabs.</p>\n<p>The <a href=\"http://design.ubuntu.com/apps/global-patterns/navigation\">Navigation Patterns</a> specify that a tabs header should never be combined with the back button of a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a>. The only way to combine Tabs and <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a> that avoids this is by pushing the Tabs as the first page on the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a>, and pushing other pages on top of that, as is shown in the following example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.MainView/\">MainView</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">mainView</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">38</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">50</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.PageStack/\">PageStack</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">pageStack</span>\n <span class=\"name\">Component</span>.onCompleted: <span class=\"name\">push</span>(<span class=\"name\">tabs</span>)\n <span class=\"type\">Tabs</span> {\n <span class=\"name\">id</span>: <span class=\"name\">tabs</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Tab 1&quot;</span>\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">page3</span>)\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Press&quot;</span>\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Tab 2&quot;</span>\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Use header to navigate between tabs&quot;</span>\n }\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Page/\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page3</span>\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page on stack&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Label/\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Press back to return to the tabs&quot;</span>\n }\n }\n }\n}</pre>\n<!-- @@@Tabs -->\n<h2>Property Documentation</h2>\n<!-- $$$currentPage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"currentPage-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">currentPage</span> : <span class=\"type\">Item</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The page of the currently selected tab.</p>\n</div></div><!-- @@@currentPage -->\n<br/>\n<!-- $$$selectedTab -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTab-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">selectedTab</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Tab/\">Tab</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The currently selected tab.</p>\n</div></div><!-- @@@selectedTab -->\n<br/>\n<!-- $$$selectedTabIndex -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTabIndex-prop\"></a><span class=\"name\">selectedTabIndex</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The index of the currently selected tab. The first tab is 0, and -1 means that no tab is selected. The initial value is 0 if Tabs has contents, or -1 otherwise.</p>\n</div></div><!-- @@@selectedTabIndex -->\n<br/>\n<!-- $$$tabBar -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabBar-prop\"></a><span class=\"name\">tabBar</span> : <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TabBar/\">TabBar</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TabBar/\">TabBar</a> that will be shown in the header and provides scrollable tab buttons.</p>\n</div></div><!-- @@@tabBar -->\n<br/>\n<!-- $$$tabChildren -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabChildren-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">tabChildren</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">Item</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Children are placed in a separate item that has functionality to extract the Tab items.</p>\n</div></div><!-- @@@tabChildren -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$modelChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"modelChanged-signal\"></a>Tabs::<span class=\"name\">modelChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Used by the tabs style to update the tabs header with the titles of all the tabs. This signal is used in an intermediate step in transitioning the tabs to a new implementation and may be removed in the future.</p>\n</div></div><!-- @@@modelChanged -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/506/", "name": "Tabs", "description": "The Tabs class provides an environment where multible <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a> children can be added, and the user is presented with a tab bar with tab buttons to select different tab pages. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.Tabs", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$Tabs-brief -->\n<p>The Tabs class provides an environment where multible <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a> children can be added, and the user is presented with a tab bar with tab buttons to select different tab pages. <a href=\"#details\">More...</a></p>\n<!-- @@@Tabs -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#count-prop\">count</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#currentPage-prop\">currentPage</a></b></b> : Item</li>\n<li class=\"fn\"><b><b><a href=\"#selectedTab-prop\">selectedTab</a></b></b> : Tab<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#selectedTabIndex-prop\">selectedTabIndex</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#tabBar-prop\">tabBar</a></b></b> : TabBar</li>\n<li class=\"fn\"><b><b><a href=\"#tabChildren-prop\">tabChildren</a></b></b> : list&lt;Item&gt;</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#modelChanged-signal\">modelChanged</a></b></b>()<tt> (deprecated)</tt></li>\n</ul>\n<!-- $$$Tabs-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>Tabs must be placed inside a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a> so that it will automatically have a header that shows the tabs that can be selected, and the toolbar which contains the tools of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> in the currently selected <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a>.</p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/tabs\">See also the Design Guidelines on Tabs</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\nimport Ubuntu.Components.ListItems 0.1 as ListItem\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">48</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n <span class=\"type\">Tabs</span> {\n <span class=\"name\">id</span>: <span class=\"name\">tabs</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;Simple page&quot;</span>)\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">label</span>\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;A centered label&quot;</span>\n }\n <span class=\"name\">tools</span>: <span class=\"name\">ToolbarItems</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ToolbarButton\">ToolbarButton</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;action&quot;</span>\n <span class=\"name\">onTriggered</span>: <span class=\"name\">print</span>(<span class=\"string\">&quot;action triggered&quot;</span>)\n }\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">externalTab</span>\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;External&quot;</span>)\n <span class=\"name\">page</span>: <span class=\"name\">Loader</span> {\n <span class=\"name\">parent</span>: <span class=\"name\">externalTab</span>\n <span class=\"type\">anchors</span> {\n <span class=\"name\">left</span>: <span class=\"name\">parent</span>.<span class=\"name\">left</span>\n <span class=\"name\">right</span>: <span class=\"name\">parent</span>.<span class=\"name\">right</span>\n <span class=\"name\">bottom</span>: <span class=\"name\">parent</span>.<span class=\"name\">bottom</span>\n }\n <span class=\"name\">source</span>: (<span class=\"name\">tabs</span>.<span class=\"name\">selectedTab</span> <span class=\"operator\">===</span> <span class=\"name\">externalTab</span>) ? <span class=\"name\">Qt</span>.<span class=\"name\">resolvedUrl</span>(<span class=\"string\">&quot;MyCustomPage.qml&quot;</span>) : <span class=\"string\">&quot;&quot;</span>\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"name\">i18n</span>.<span class=\"name\">tr</span>(<span class=\"string\">&quot;List view&quot;</span>)\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.ListView\">ListView</a></span> {\n <span class=\"name\">clip</span>: <span class=\"number\">true</span>\n <span class=\"name\">anchors</span>.fill: <span class=\"name\">parent</span>\n <span class=\"name\">model</span>: <span class=\"number\">20</span>\n <span class=\"name\">delegate</span>: <span class=\"name\">ListItem</span>.Standard {\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Item &quot;</span><span class=\"operator\">+</span><span class=\"name\">modelData</span>\n }\n }\n }\n }\n }\n}</pre>\n<p>As the example above shows, an external <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> inside a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a> can be loaded using a Loader. Note that setting the top anchor or the height of the Loader would override the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> height. We avoid this because the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a> automatically adapts its height to accommodate for the header.</p>\n<p>It is possible to use a Repeater to generate tabs, but when doing so, ensure that the Repeater is declared inside the Tabs at the end, because otherwise the shuffling of the order of children by the Repeater can cause incorrect ordering of the tabs.</p>\n<p>The <a href=\"http://design.ubuntu.com/apps/global-patterns/navigation\">Navigation Patterns</a> specify that a tabs header should never be combined with the back button of a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a>. The only way to combine Tabs and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a> that avoids this is by pushing the Tabs as the first page on the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a>, and pushing other pages on top of that, as is shown in the following example:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.MainView\">MainView</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">mainView</span>\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">38</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">50</span>)\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.PageStack\">PageStack</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">pageStack</span>\n <span class=\"name\">Component</span>.onCompleted: <span class=\"name\">push</span>(<span class=\"name\">tabs</span>)\n <span class=\"type\">Tabs</span> {\n <span class=\"name\">id</span>: <span class=\"name\">tabs</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Tab 1&quot;</span>\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">pageStack</span>.<span class=\"name\">push</span>(<span class=\"name\">page3</span>)\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Press&quot;</span>\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span> {\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Tab 2&quot;</span>\n <span class=\"name\">page</span>: <span class=\"name\">Page</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Use header to navigate between tabs&quot;</span>\n }\n }\n }\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Page\">Page</a></span> {\n <span class=\"name\">id</span>: <span class=\"name\">page3</span>\n <span class=\"name\">visible</span>: <span class=\"number\">false</span>\n <span class=\"name\">title</span>: <span class=\"string\">&quot;Page on stack&quot;</span>\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Label\">Label</a></span> {\n <span class=\"name\">anchors</span>.centerIn: <span class=\"name\">parent</span>\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Press back to return to the tabs&quot;</span>\n }\n }\n }\n}</pre>\n<!-- @@@Tabs -->\n<h2>Property Documentation</h2>\n<!-- $$$count -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"count-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">count</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Contains the number of tabs in the Tabs component.</p>\n</div></div><!-- @@@count -->\n<br/>\n<!-- $$$currentPage -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"currentPage-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">currentPage</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The page of the currently selected tab.</p>\n</div></div><!-- @@@currentPage -->\n<br/>\n<!-- $$$selectedTab -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTab-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">selectedTab</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Tab\">Tab</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The currently selected tab.</p>\n</div></div><!-- @@@selectedTab -->\n<br/>\n<!-- $$$selectedTabIndex -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTabIndex-prop\"></a><span class=\"name\">selectedTabIndex</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>The index of the currently selected tab. The first tab is 0, and -1 means that no tab is selected. The initial value is 0 if Tabs has contents, or -1 otherwise.</p>\n</div></div><!-- @@@selectedTabIndex -->\n<br/>\n<!-- $$$tabBar -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabBar-prop\"></a><span class=\"name\">tabBar</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TabBar\">TabBar</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TabBar\">TabBar</a> that will be shown in the header and provides scrollable tab buttons.</p>\n</div></div><!-- @@@tabBar -->\n<br/>\n<!-- $$$tabChildren -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"tabChildren-prop\"></a><span class=\"qmldefault\">default</span><span class=\"name\">tabChildren</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-list.html\">list</a></span>&lt;<span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Children are placed in a separate item that has functionality to extract the Tab items.</p>\n</div></div><!-- @@@tabChildren -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$modelChanged -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"modelChanged-signal\"></a>Tabs::<span class=\"name\">modelChanged</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>Used by the tabs style to update the tabs header with the titles of all the tabs. This signal is used in an intermediate step in transitioning the tabs to a new implementation and may be removed in the future.</p>\n</div></div><!-- @@@modelChanged -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-tabs.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/195/", "name": "TextArea", "description": "The TextArea item displays a block of editable, scrollable, formatted text. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.TextArea", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$TextArea-brief -->\n<p>The TextArea item displays a block of editable, scrollable, formatted text. <a href=\"#details\">More...</a></p>\n<!-- @@@TextArea -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#activeFocusOnPress-prop\">activeFocusOnPress</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#autoExpand-prop\">autoExpand</a></b></b> : bool<tt> (deprecated)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#autoSize-prop\">autoSize</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#baseUrl-prop\">baseUrl</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#canPaste-prop\">canPaste</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canRedo-prop\">canRedo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canUndo-prop\">canUndo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#contentHeight-prop\">contentHeight</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#contentWidth-prop\">contentWidth</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#cursorDelegate-prop\">cursorDelegate</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#cursorPosition-prop\">cursorPosition</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#cursorRectangle-prop\">cursorRectangle</a></b></b> : rectangle</li>\n<li class=\"fn\"><b><b><a href=\"#cursorVisible-prop\">cursorVisible</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#displayText-prop\">displayText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#font-prop\">font</a></b></b> : font</li>\n<li class=\"fn\"><b><b><a href=\"#highlighted-prop\">highlighted</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#horizontalAlignment-prop\">horizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodComposing-prop\">inputMethodComposing</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodHints-prop\">inputMethodHints</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#length-prop\">length</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#lineCount-prop\">lineCount</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#maximumLineCount-prop\">maximumLineCount</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#persistentSelection-prop\">persistentSelection</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#placeholderText-prop\">placeholderText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#popover-prop\">popover</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#readOnly-prop\">readOnly</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#renderType-prop\">renderType</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#selectByMouse-prop\">selectByMouse</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#selectedText-prop\">selectedText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#selectedTextColor-prop\">selectedTextColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionColor-prop\">selectionColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionEnd-prop\">selectionEnd</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#selectionStart-prop\">selectionStart</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#textFormat-prop\">textFormat</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#verticalAlignment-prop\">verticalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#wrapMode-prop\">wrapMode</a></b></b> : enumeration</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#linkActivated-signal\">linkActivated</a></b></b>(string <i>link</i>)</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#copy-method\">copy</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#cut-method\">cut</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#deselect-method\">deselect</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#getFormattedText-method\">getFormattedText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#getText-method\">getText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#insert-method\">insert</a></b></b>(<i>position</i>, <i>text</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#isRightToLeft-method\">isRightToLeft</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#moveCursorSelection-method\">moveCursorSelection</a></b></b>(<i>position</i>, <i>mode</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#paste-method\">paste</a></b></b>(<i>data</i>)<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#positionAt-method\">positionAt</a></b></b>(<i>x</i>, <i>y</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionToRectangle-method\">positionToRectangle</a></b></b>(<i>position</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#redo-method\">redo</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#remove-method\">remove</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#select-method\">select</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#selectAll-method\">selectAll</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#selectWord-method\">selectWord</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#undo-method\">undo</a></b></b>()</li>\n</ul>\n<!-- $$$TextArea-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The TextArea supports fix-size and auto-expanding modes. In fix-size mode the content is scrolled when exceeds the boundaries and can be scrolled both horizontally and vertically, depending on the <a href=\"#contentWidth-prop\">contentWidth</a> and <a href=\"#contentHeight-prop\">contentHeight</a> set. The following example will scroll the editing area both horizontally and vertically:</p>\n<pre class=\"qml\"><span class=\"type\">TextArea</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">12</span>)\n <span class=\"name\">contentWidth</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">contentHeight</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n}</pre>\n<p>The auto-expand mode is realized using two properties: <a href=\"#autoSize-prop\">autoSize</a> and <a href=\"#maximumLineCount-prop\">maximumLineCount</a>. Setting <a href=\"#autoSize-prop\">autoSize</a> will set implicitHeight to one line, and the height will follow the line count, meaning when lines are added the area will expand and when removed the area will shrink. The <a href=\"#maximumLineCount-prop\">maximumLineCount</a> specifies how much the editor should be expanded. If this value is set to 0, the area will always expand vertically to fit the content. When <a href=\"#autoSize-prop\">autoSize</a> is set, the <a href=\"#contentHeight-prop\">contentHeight</a> property value is ignored, and the expansion only happens vertically.</p>\n<pre class=\"qml\"><span class=\"type\">TextArea</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">12</span>)\n <span class=\"name\">contentWidth</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">autoSize</span>: <span class=\"number\">true</span>\n <span class=\"name\">maximumLineCount</span>: <span class=\"number\">0</span>\n}</pre>\n<p>TextArea comes with 30 grid-units implicit width and one line height on auto-sizing mode and 4 lines on fixed-mode. The line size is calculated from the font size and the ovarlay and frame spacing specified in the style.</p>\n<p>Scrolling the editing area can happen when the size is fixed or in auto-sizing mode when the content size is bigger than the visible area. The scrolling is realized by swipe gestures, or by navigating the cursor.</p>\n<p>The item enters in selection mode when the user performs a long tap (or long mouse press) or a double tap/press on the text area. The mode is visualized by two selection cursors (pins) which can be used to select the desired text. The text can also be selected by moving the finger/mouse towards the desired area right after entering in selection mode. The way the text is selected is driven by the <a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a> value, which is either character or word. The editor leaves the selection mode by pressing/tapping again on it or by losing focus.</p>\n<p><b>This component is under heavy development.</b></p>\n<!-- @@@TextArea -->\n<h2>Property Documentation</h2>\n<!-- $$$activeFocusOnPress -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"activeFocusOnPress-prop\"></a><span class=\"name\">activeFocusOnPress</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> should gain active focus on a mouse press. By default this is set to true.</p>\n</div></div><!-- @@@activeFocusOnPress -->\n<br/>\n<!-- $$$autoExpand -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoExpand-prop\"></a><span class=\"name\">autoExpand</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>This property specifies whether the text area expands following the entered text or not. The default value is false. The property is deprecated, use <a href=\"#autoSize-prop\">autoSize</a> instead</p>\n</div></div><!-- @@@autoExpand -->\n<br/>\n<!-- $$$autoSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoSize-prop\"></a><span class=\"name\">autoSize</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property specifies whether the text area sizes following the line count or not. The default value is false.</p>\n</div></div><!-- @@@autoSize -->\n<br/>\n<!-- $$$baseUrl -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"baseUrl-prop\"></a><span class=\"name\">baseUrl</span> : <span class=\"type\">url</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property specifies a base URL which is used to resolve relative URLs within the text. The default value is the url of the QML file instantiating the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> item.</p>\n</div></div><!-- @@@baseUrl -->\n<br/>\n<!-- $$$canPaste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canPaste-prop\"></a><span class=\"name\">canPaste</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> is writable and the content of the clipboard is suitable for pasting into the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>.</p>\n</div></div><!-- @@@canPaste -->\n<br/>\n<!-- $$$canRedo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canRedo-prop\"></a><span class=\"name\">canRedo</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> is writable and there are undone operations that can be redone.</p>\n</div></div><!-- @@@canRedo -->\n<br/>\n<!-- $$$canUndo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canUndo-prop\"></a><span class=\"name\">canUndo</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> is writable and there are previous operations that can be undone.</p>\n</div></div><!-- @@@canUndo -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text color.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$contentHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentHeight-prop\"></a><span class=\"name\">contentHeight</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property folds the height of the text editing content. This can be equal or bigger than the frame height minus the spacing between the frame and the input area defined in the current theme. The default value is the same as the visible input area's height.</p>\n</div></div><!-- @@@contentHeight -->\n<br/>\n<!-- $$$contentWidth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentWidth-prop\"></a><span class=\"name\">contentWidth</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property folds the width of the text editing content. This can be equal or bigger than the frame width minus the spacing between the frame and the input area defined in the current theme. The default value is the same as the visible input area's width.</p>\n</div></div><!-- @@@contentWidth -->\n<br/>\n<!-- $$$cursorDelegate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorDelegate-prop\"></a><span class=\"name\">cursorDelegate</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The delegate for the cursor in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>.</p>\n<p>If you set a cursorDelegate for a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>, this delegate will be used for drawing the cursor instead of the standard cursor. An instance of the delegate will be created and managed by the text edit when a cursor is needed, and the x and y properties of delegate instance will be set so as to be one pixel before the top left of the current character.</p>\n<p>Note that the root item of the delegate component must be a QQuickItem or QQuickItem derived item.</p>\n</div></div><!-- @@@cursorDelegate -->\n<br/>\n<!-- $$$cursorPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorPosition-prop\"></a><span class=\"name\">cursorPosition</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the cursor in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>.</p>\n</div></div><!-- @@@cursorPosition -->\n<br/>\n<!-- $$$cursorRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorRectangle-prop\"></a><span class=\"name\">cursorRectangle</span> : <span class=\"type\">rectangle</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The rectangle where the standard text cursor is rendered within the text edit. Read-only.</p>\n<p>The position and height of a custom <a href=\"#cursorDelegate-prop\">cursorDelegate</a> are updated to follow the cursorRectangle automatically when it changes. The width of the delegate is unaffected by changes in the cursor rectangle.</p>\n</div></div><!-- @@@cursorRectangle -->\n<br/>\n<!-- $$$cursorVisible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorVisible-prop\"></a><span class=\"name\">cursorVisible</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>If true the text edit shows a cursor.</p>\n<p>This property is set and unset when the text edit gets active focus, but it can also be set directly (useful, for example, if a KeyProxy might forward keys to it).</p>\n</div></div><!-- @@@cursorVisible -->\n<br/>\n<!-- $$$displayText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"displayText-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">displayText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property contains the text that is displayed on the screen. May differ from the text property value when TextEdit.RichText format is selected.</p>\n</div></div><!-- @@@displayText -->\n<br/>\n<!-- $$$effectiveHorizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"effectiveHorizontalAlignment-prop\"></a><span class=\"name\">effectiveHorizontalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Presents the effective horizontal alignment that can be different from the one specified at <a href=\"#horizontalAlignment-prop\">horizontalAlignment</a> due to layout mirroring.</p>\n</div></div><!-- @@@effectiveHorizontalAlignment -->\n<br/>\n<!-- $$$font -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"font-prop\"></a><span class=\"name\">font</span> : <span class=\"type\"><a href=\"#font-prop\">font</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the font used by the editing.</p>\n</div></div><!-- @@@font -->\n<br/>\n<!-- $$$highlighted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"highlighted-prop\"></a><span class=\"name\">highlighted</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property presents whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> is highlighted or not. By default the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> gets highlighted when gets the focus, so can accept text input. This property allows to control the highlight separately from the focused behavior.</p>\n</div></div><!-- @@@highlighted -->\n<br/>\n<!-- $$$horizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"horizontalAlignment-prop\"></a><span class=\"name\">horizontalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the horizontal alignment of the text within the TextAre item's width and height. By default, the text alignment follows the natural alignment of the text, for example text that is read from left to right will be aligned to the left.</p>\n<p>Valid values for <a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a> are:</p>\n<ul>\n<li>TextEdit.AlignLeft (default)</li>\n<li>TextEdit.AlignRight</li>\n<li>TextEdit.AlignHCenter</li>\n<li>TextEdit.AlignJustify</li>\n</ul>\n</div></div><!-- @@@horizontalAlignment -->\n<br/>\n<!-- $$$inputMethodComposing -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodComposing-prop\"></a><span class=\"name\">inputMethodComposing</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> has partial text input from an input method.</p>\n<p>While it is composing an input method may rely on mouse or key events from the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> to edit or commit the partial text. This property can be used to determine when to disable events handlers that may interfere with the correct operation of an input method.</p>\n</div></div><!-- @@@inputMethodComposing -->\n<br/>\n<!-- $$$inputMethodHints -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodHints-prop\"></a><span class=\"name\">inputMethodHints</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides hints to the input method about the expected content of the text edit and how it should operate.</p>\n<p>The value is a bit-wise combination of flags or Qt.ImhNone if no hints are set.</p>\n<p>Flags that alter behaviour are:</p>\n<ul>\n<li>Qt.ImhHiddenText - Characters should be hidden, as is typically used when entering passwords.</li>\n<li>Qt.ImhSensitiveData - Typed text should not be stored by the active input method in any persistent storage like predictive user dictionary.</li>\n<li>Qt.ImhNoAutoUppercase - The input method should not try to automatically switch to upper case when a sentence ends.</li>\n<li>Qt.ImhPreferNumbers - Numbers are preferred (but not required).</li>\n<li>Qt.ImhPreferUppercase - Upper case letters are preferred (but not required).</li>\n<li>Qt.ImhPreferLowercase - Lower case letters are preferred (but not required).</li>\n<li>Qt.ImhNoPredictiveText - Do not use predictive text (i.e&#x2e; dictionary lookup) while typing.</li>\n<li>Qt.ImhDate - The text editor functions as a date field.</li>\n<li>Qt.ImhTime - The text editor functions as a time field.</li>\n</ul>\n<p>Flags that restrict input (exclusive flags) are:</p>\n<ul>\n<li>Qt.ImhDigitsOnly - Only digits are allowed.</li>\n<li>Qt.ImhFormattedNumbersOnly - Only number input is allowed. This includes decimal point and minus sign.</li>\n<li>Qt.ImhUppercaseOnly - Only upper case letter input is allowed.</li>\n<li>Qt.ImhLowercaseOnly - Only lower case letter input is allowed.</li>\n<li>Qt.ImhDialableCharactersOnly - Only characters suitable for phone dialing are allowed.</li>\n<li>Qt.ImhEmailCharactersOnly - Only characters suitable for email addresses are allowed.</li>\n<li>Qt.ImhUrlCharactersOnly - Only characters suitable for URLs are allowed.</li>\n</ul>\n<p>Masks:</p>\n<ul>\n<li>Qt.ImhExclusiveInputMask - This mask yields nonzero if any of the exclusive flags are used.</li>\n</ul>\n</div></div><!-- @@@inputMethodHints -->\n<br/>\n<!-- $$$length -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"length-prop\"></a><span class=\"name\">length</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the total number of plain text characters in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> item.</p>\n<p>As this number doesn't include any formatting markup it may not be the same as the length of the string returned by the text property.</p>\n<p>This property can be faster than querying the length the text property as it doesn't require any copying or conversion of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>'s internal string data.</p>\n</div></div><!-- @@@length -->\n<br/>\n<!-- $$$lineCount -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"lineCount-prop\"></a><span class=\"name\">lineCount</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the total number of lines in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> item.</p>\n</div></div><!-- @@@lineCount -->\n<br/>\n<!-- $$$maximumLineCount -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumLineCount-prop\"></a><span class=\"name\">maximumLineCount</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the maximum amount of lines to expand when <a href=\"#autoSize-prop\">autoSize</a> is enabled. The value of 0 does not put any upper limit and the control will expand forever.</p>\n<p>The default value is 5 lines.</p>\n</div></div><!-- @@@maximumLineCount -->\n<br/>\n<!-- $$$mouseSelectionMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"mouseSelectionMode-prop\"></a><span class=\"name\">mouseSelectionMode</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies how text should be selected using a mouse.</p>\n<ul>\n<li>TextEdit.SelectCharacters - The selection is updated with individual characters. (Default)</li>\n<li>TextEdit.SelectWords - The selection is updated with whole words.</li>\n</ul>\n<p>This property only applies when <a href=\"#selectByMouse-prop\">selectByMouse</a> is true.</p>\n</div></div><!-- @@@mouseSelectionMode -->\n<br/>\n<!-- $$$persistentSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"persistentSelection-prop\"></a><span class=\"name\">persistentSelection</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> should keep the selection visible when it loses active focus to another item in the scene. By default this is set to true;</p>\n</div></div><!-- @@@persistentSelection -->\n<br/>\n<!-- $$$placeholderText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"placeholderText-prop\"></a><span class=\"name\">placeholderText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Text that appears when there is no focus and no content in the component (hint text).</p>\n</div></div><!-- @@@placeholderText -->\n<br/>\n<!-- $$$popover -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"popover-prop\"></a><span class=\"name\">popover</span> : <span class=\"type\">var</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property overrides the default popover of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>. When set, the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> will open the given popover instead of the default one defined. The popover can either be a component or a URL to be loaded.</p>\n</div></div><!-- @@@popover -->\n<br/>\n<!-- $$$readOnly -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"readOnly-prop\"></a><span class=\"name\">readOnly</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the user can interact with the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> item. If this property is set to true the text cannot be edited by user interaction.</p>\n<p>By default this property is false.</p>\n</div></div><!-- @@@readOnly -->\n<br/>\n<!-- $$$renderType -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"renderType-prop\"></a><span class=\"name\">renderType</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Override the default rendering type for this component.</p>\n<p>Supported render types are:</p>\n<ul>\n<li>Text.QtRendering - the default</li>\n<li>Text.NativeRendering</li>\n</ul>\n<p>Select Text.NativeRendering if you prefer text to look native on the target platform and do not require advanced features such as transformation of the text. Using such features in combination with the NativeRendering render type will lend poor and sometimes pixelated results.</p>\n</div></div><!-- @@@renderType -->\n<br/>\n<!-- $$$selectByMouse -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectByMouse-prop\"></a><span class=\"name\">selectByMouse</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property drives whether text selection should happen with the mouse or not. The default value is true.</p>\n</div></div><!-- @@@selectByMouse -->\n<br/>\n<!-- $$$selectedText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedText-prop\"></a><span class=\"name\">selectedText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This read-only property provides the text currently selected in the text edit.</p>\n</div></div><!-- @@@selectedText -->\n<br/>\n<!-- $$$selectedTextColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTextColor-prop\"></a><span class=\"name\">selectedTextColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The selected text color, used in selections.</p>\n</div></div><!-- @@@selectedTextColor -->\n<br/>\n<!-- $$$selectionColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionColor-prop\"></a><span class=\"name\">selectionColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text highlight color, used behind selections.</p>\n</div></div><!-- @@@selectionColor -->\n<br/>\n<!-- $$$selectionEnd -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionEnd-prop\"></a><span class=\"name\">selectionEnd</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position after the last character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start, end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n<p>See also <a href=\"#selectionStart-prop\">selectionStart</a>, <a href=\"#cursorPosition-prop\">cursorPosition</a>, and <a href=\"#selectedText-prop\">selectedText</a>.</p>\n</div></div><!-- @@@selectionEnd -->\n<br/>\n<!-- $$$selectionStart -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionStart-prop\"></a><span class=\"name\">selectionStart</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position before the first character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start, end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n<p>See also <a href=\"#selectionEnd-prop\">selectionEnd</a>, <a href=\"#cursorPosition-prop\">cursorPosition</a>, and <a href=\"#selectedText-prop\">selectedText</a>.</p>\n</div></div><!-- @@@selectionStart -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text to display. If the text format is AutoText the text edit will automatically determine whether the text should be treated as rich text. This determination is made using Qt::mightBeRichText().</p>\n</div></div><!-- @@@text -->\n<br/>\n<!-- $$$textFormat -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"textFormat-prop\"></a><span class=\"name\">textFormat</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The way the text property should be displayed.</p>\n<ul>\n<li>TextEdit.AutoText</li>\n<li>TextEdit.PlainText</li>\n<li>TextEdit.RichText</li>\n</ul>\n<p>The default is TextEdit.PlainText. If the text format is TextEdit.AutoText the text edit will automatically determine whether the text should be treated as rich text. This determination is made using Qt::mightBeRichText().</p>\n</div></div><!-- @@@textFormat -->\n<br/>\n<!-- $$$verticalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"verticalAlignment-prop\"></a><span class=\"name\">verticalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the vertical alignment of the text within the TextAres item's width and height. By default, the text alignment follows the natural alignment of the text.</p>\n<p>Valid values for verticalAlignment are:</p>\n<ul>\n<li>TextEdit.AlignTop (default)</li>\n<li>TextEdit.AlignBottom</li>\n<li>TextEdit.AlignVCenter</li>\n</ul>\n</div></div><!-- @@@verticalAlignment -->\n<br/>\n<!-- $$$wrapMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"wrapMode-prop\"></a><span class=\"name\">wrapMode</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Set this property to wrap the text to the TextEdit item's width. The text will only wrap if an explicit width has been set.</p>\n<ul>\n<li>TextEdit.NoWrap - no wrapping will be performed. If the text contains insufficient newlines, then implicitWidth will exceed a set width.</li>\n<li>TextEdit.WordWrap - wrapping is done on word boundaries only. If a word is too long, implicitWidth will exceed a set width.</li>\n<li>TextEdit.WrapAnywhere - wrapping is done at any point on a line, even if it occurs in the middle of a word.</li>\n<li>TextEdit.Wrap - if possible, wrapping occurs at a word boundary; otherwise it will occur at the appropriate point on the line, even in the middle of a word.</li>\n</ul>\n<p>The default is TextEdit.Wrap</p>\n</div></div><!-- @@@wrapMode -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$linkActivated -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"linkActivated-signal\"></a>TextArea::<span class=\"name\">linkActivated</span>(<span class=\"type\">string</span><i> link</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when the user clicks on a link embedded in the text. The link must be in rich text or HTML format and the link string provides access to the particular link.</p>\n</div></div><!-- @@@linkActivated -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$copy -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"copy-method\"></a>TextArea::<span class=\"name\">copy</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Copies the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@copy -->\n<br/>\n<!-- $$$cut -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"cut-method\"></a>TextArea::<span class=\"name\">cut</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@cut -->\n<br/>\n<!-- $$$deselect -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"deselect-method\"></a>TextArea::<span class=\"name\">deselect</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes active text selection.</p>\n</div></div><!-- @@@deselect -->\n<br/>\n<!-- $$$getFormattedText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"getFormattedText-method\"></a>TextArea::<span class=\"name\">getFormattedText</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the section of text that is between the start and end positions.</p>\n<p>The returned text will be formatted according the <a href=\"#textFormat-prop\">textFormat</a> property.</p>\n</div></div><!-- @@@getFormattedText -->\n<br/>\n<!-- $$$getText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"getText-method\"></a>TextArea::<span class=\"name\">getText</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the section of text that is between the start and end positions.</p>\n<p>The returned text does not include any rich text formatting. A getText(0, length) will result in the same value as <a href=\"#displayText-prop\">displayText</a>.</p>\n</div></div><!-- @@@getText -->\n<br/>\n<!-- $$$insert -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"insert-method\"></a>TextArea::<span class=\"name\">insert</span>(<i> position</i>, <i> text</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Inserts text into the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a> at position.</p>\n</div></div><!-- @@@insert -->\n<br/>\n<!-- $$$isRightToLeft -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"isRightToLeft-method\"></a>TextArea::<span class=\"name\">isRightToLeft</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the natural reading direction of the editor text found between positions start and end is right to left.</p>\n</div></div><!-- @@@isRightToLeft -->\n<br/>\n<!-- $$$moveCursorSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"moveCursorSelection-method\"></a>TextArea::<span class=\"name\">moveCursorSelection</span>(<i> position</i>, <i> mode</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the cursor to position and updates the selection according to the optional mode parameter. (To only move the cursor, set the <a href=\"#cursorPosition-prop\">cursorPosition</a> property.)</p>\n<p>When this method is called it additionally sets either the <a href=\"#selectionStart-prop\">selectionStart</a> or the <a href=\"#selectionEnd-prop\">selectionEnd</a> (whichever was at the previous cursor position) to the specified position. This allows you to easily extend and contract the selected text range.</p>\n<p>The selection mode specifies whether the selection is updated on a per character or a per word basis. If not specified the selection mode will default to whatever is given in the <a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a> property.</p>\n</div></div><!-- @@@moveCursorSelection -->\n<br/>\n<!-- $$$paste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"paste-method\"></a>TextArea::<span class=\"name\">paste</span>(<i> data</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Places the clipboard or the data given as parameter into the text input. The selected text will be replaces with the data.</p>\n</div></div><!-- @@@paste -->\n<br/>\n<!-- $$$positionAt -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionAt-method\"></a>TextArea::<span class=\"name\">positionAt</span>(<i> x</i>, <i> y</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the text position closest to pixel position (x, y).</p>\n<p>Position 0 is before the first character, position 1 is after the first character but before the second, and so on until position text.length, which is after all characters.</p>\n</div></div><!-- @@@positionAt -->\n<br/>\n<!-- $$$positionToRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionToRectangle-method\"></a>TextArea::<span class=\"name\">positionToRectangle</span>(<i> position</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the rectangle at the given position in the text. The x, y, and height properties correspond to the cursor that would describe that position.</p>\n</div></div><!-- @@@positionToRectangle -->\n<br/>\n<!-- $$$redo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"redo-method\"></a>TextArea::<span class=\"name\">redo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Redoes the last operation if redo is <a href=\"#canRedo-prop\">available</a>.</p>\n</div></div><!-- @@@redo -->\n<br/>\n<!-- $$$remove -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"remove-method\"></a>TextArea::<span class=\"name\">remove</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes the section of text that is between the start and end positions from the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextArea/\">TextArea</a>.</p>\n</div></div><!-- @@@remove -->\n<br/>\n<!-- $$$select -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"select-method\"></a>TextArea::<span class=\"name\">select</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the text from start to end to be selected.</p>\n<p>If either start or end is out of range, the selection is not changed.</p>\n<p>After calling this, <a href=\"#selectionStart-prop\">selectionStart</a> will become the lesser and <a href=\"#selectionEnd-prop\">selectionEnd</a> will become the greater (regardless of the order passed to this method).</p>\n<p>See also <a href=\"#selectionStart-prop\">selectionStart</a> and <a href=\"#selectionEnd-prop\">selectionEnd</a>.</p>\n</div></div><!-- @@@select -->\n<br/>\n<!-- $$$selectAll -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectAll-method\"></a>TextArea::<span class=\"name\">selectAll</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes all text to be selected.</p>\n</div></div><!-- @@@selectAll -->\n<br/>\n<!-- $$$selectWord -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectWord-method\"></a>TextArea::<span class=\"name\">selectWord</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the word closest to the current cursor position to be selected.</p>\n</div></div><!-- @@@selectWord -->\n<br/>\n<!-- $$$undo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"undo-method\"></a>TextArea::<span class=\"name\">undo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Undoes the last operation if undo is <a href=\"#canUndo-prop\">available</a>. Deselects any current selection, and updates the selection start to the current cursor position.</p>\n</div></div><!-- @@@undo -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/507/", "name": "TextArea", "description": "The TextArea item displays a block of editable, scrollable, formatted text. ", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.TextArea", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$TextArea-brief -->\n<p>The TextArea item displays a block of editable, scrollable, formatted text. <a href=\"#details\">More...</a></p>\n<!-- @@@TextArea -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.StyledItem\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#activeFocusOnPress-prop\">activeFocusOnPress</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#autoExpand-prop\">autoExpand</a></b></b> : bool<tt> (deprecated)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#autoSize-prop\">autoSize</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#baseUrl-prop\">baseUrl</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#canPaste-prop\">canPaste</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canRedo-prop\">canRedo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canUndo-prop\">canUndo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#contentHeight-prop\">contentHeight</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#contentWidth-prop\">contentWidth</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#cursorDelegate-prop\">cursorDelegate</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#cursorPosition-prop\">cursorPosition</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#cursorRectangle-prop\">cursorRectangle</a></b></b> : rectangle</li>\n<li class=\"fn\"><b><b><a href=\"#cursorVisible-prop\">cursorVisible</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#displayText-prop\">displayText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#font-prop\">font</a></b></b> : font</li>\n<li class=\"fn\"><b><b><a href=\"#highlighted-prop\">highlighted</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#horizontalAlignment-prop\">horizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodComposing-prop\">inputMethodComposing</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodHints-prop\">inputMethodHints</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#length-prop\">length</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#lineCount-prop\">lineCount</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#maximumLineCount-prop\">maximumLineCount</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#persistentSelection-prop\">persistentSelection</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#placeholderText-prop\">placeholderText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#popover-prop\">popover</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#readOnly-prop\">readOnly</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#renderType-prop\">renderType</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#selectByMouse-prop\">selectByMouse</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#selectedText-prop\">selectedText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#selectedTextColor-prop\">selectedTextColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionColor-prop\">selectionColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionEnd-prop\">selectionEnd</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#selectionStart-prop\">selectionStart</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#textFormat-prop\">textFormat</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#verticalAlignment-prop\">verticalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#wrapMode-prop\">wrapMode</a></b></b> : enumeration</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#linkActivated-signal\">linkActivated</a></b></b>(string <i>link</i>)</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#copy-method\">copy</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#cut-method\">cut</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#deselect-method\">deselect</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#getFormattedText-method\">getFormattedText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#getText-method\">getText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#insert-method\">insert</a></b></b>(<i>position</i>, <i>text</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#isRightToLeft-method\">isRightToLeft</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#moveCursorSelection-method\">moveCursorSelection</a></b></b>(<i>position</i>, <i>mode</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#paste-method\">paste</a></b></b>(<i>data</i>)<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#positionAt-method\">positionAt</a></b></b>(<i>x</i>, <i>y</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionToRectangle-method\">positionToRectangle</a></b></b>(<i>position</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#redo-method\">redo</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#remove-method\">remove</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#select-method\">select</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#selectAll-method\">selectAll</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#selectWord-method\">selectWord</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#undo-method\">undo</a></b></b>()</li>\n</ul>\n<!-- $$$TextArea-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p>The TextArea supports fix-size and auto-expanding modes. In fix-size mode the content is scrolled when exceeds the boundaries and can be scrolled both horizontally and vertically, depending on the <a href=\"#contentWidth-prop\">contentWidth</a> and <a href=\"#contentHeight-prop\">contentHeight</a> set. The following example will scroll the editing area both horizontally and vertically:</p>\n<pre class=\"qml\"><span class=\"type\">TextArea</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">12</span>)\n <span class=\"name\">contentWidth</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">contentHeight</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">60</span>)\n}</pre>\n<p>The auto-expand mode is realized using two properties: <a href=\"#autoSize-prop\">autoSize</a> and <a href=\"#maximumLineCount-prop\">maximumLineCount</a>. Setting <a href=\"#autoSize-prop\">autoSize</a> will set implicitHeight to one line, and the height will follow the line count, meaning when lines are added the area will expand and when removed the area will shrink. The <a href=\"#maximumLineCount-prop\">maximumLineCount</a> specifies how much the editor should be expanded. If this value is set to 0, the area will always expand vertically to fit the content. When <a href=\"#autoSize-prop\">autoSize</a> is set, the <a href=\"#contentHeight-prop\">contentHeight</a> property value is ignored, and the expansion only happens vertically.</p>\n<pre class=\"qml\"><span class=\"type\">TextArea</span> {\n <span class=\"name\">width</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">20</span>)\n <span class=\"name\">height</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">12</span>)\n <span class=\"name\">contentWidth</span>: <span class=\"name\">units</span>.<span class=\"name\">gu</span>(<span class=\"number\">30</span>)\n <span class=\"name\">autoSize</span>: <span class=\"number\">true</span>\n <span class=\"name\">maximumLineCount</span>: <span class=\"number\">0</span>\n}</pre>\n<p>TextArea comes with 30 grid-units implicit width and one line height on auto-sizing mode and 4 lines on fixed-mode. The line size is calculated from the font size and the ovarlay and frame spacing specified in the style.</p>\n<p>Scrolling the editing area can happen when the size is fixed or in auto-sizing mode when the content size is bigger than the visible area. The scrolling is realized by swipe gestures, or by navigating the cursor.</p>\n<p>The item enters in selection mode when the user performs a long tap (or long mouse press) or a double tap/press on the text area. The mode is visualized by two selection cursors (pins) which can be used to select the desired text. The text can also be selected by moving the finger/mouse towards the desired area right after entering in selection mode. The way the text is selected is driven by the <a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a> value, which is either character or word. The editor leaves the selection mode by pressing/tapping again on it or by losing focus.</p>\n<p><b>This component is under heavy development.</b></p>\n<!-- @@@TextArea -->\n<h2>Property Documentation</h2>\n<!-- $$$activeFocusOnPress -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"activeFocusOnPress-prop\"></a><span class=\"name\">activeFocusOnPress</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the TextArea should gain active focus on a mouse press. By default this is set to true.</p>\n</div></div><!-- @@@activeFocusOnPress -->\n<br/>\n<!-- $$$autoExpand -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoExpand-prop\"></a><span class=\"name\">autoExpand</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This documentation is deprecated.</p>\n<p>This property specifies whether the text area expands following the entered text or not. The default value is false. The property is deprecated, use <a href=\"#autoSize-prop\">autoSize</a> instead</p>\n</div></div><!-- @@@autoExpand -->\n<br/>\n<!-- $$$autoSize -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoSize-prop\"></a><span class=\"name\">autoSize</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property specifies whether the text area sizes following the line count or not. The default value is false.</p>\n</div></div><!-- @@@autoSize -->\n<br/>\n<!-- $$$baseUrl -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"baseUrl-prop\"></a><span class=\"name\">baseUrl</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property specifies a base URL which is used to resolve relative URLs within the text. The default value is the url of the QML file instantiating the TextArea item.</p>\n</div></div><!-- @@@baseUrl -->\n<br/>\n<!-- $$$canPaste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canPaste-prop\"></a><span class=\"name\">canPaste</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextArea is writable and the content of the clipboard is suitable for pasting into the TextArea.</p>\n</div></div><!-- @@@canPaste -->\n<br/>\n<!-- $$$canRedo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canRedo-prop\"></a><span class=\"name\">canRedo</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextArea is writable and there are undone operations that can be redone.</p>\n</div></div><!-- @@@canRedo -->\n<br/>\n<!-- $$$canUndo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canUndo-prop\"></a><span class=\"name\">canUndo</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextArea is writable and there are previous operations that can be undone.</p>\n</div></div><!-- @@@canUndo -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text color.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$contentHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentHeight-prop\"></a><span class=\"name\">contentHeight</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property folds the height of the text editing content. This can be equal or bigger than the frame height minus the spacing between the frame and the input area defined in the current theme. The default value is the same as the visible input area's height.</p>\n</div></div><!-- @@@contentHeight -->\n<br/>\n<!-- $$$contentWidth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentWidth-prop\"></a><span class=\"name\">contentWidth</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property folds the width of the text editing content. This can be equal or bigger than the frame width minus the spacing between the frame and the input area defined in the current theme. The default value is the same as the visible input area's width.</p>\n</div></div><!-- @@@contentWidth -->\n<br/>\n<!-- $$$cursorDelegate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorDelegate-prop\"></a><span class=\"name\">cursorDelegate</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The delegate for the cursor in the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a>.</p>\n<p>If you set a cursorDelegate for a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a>, this delegate will be used for drawing the cursor instead of the standard cursor. An instance of the delegate will be created and managed by the text edit when a cursor is needed, and the x and y properties of delegate instance will be set so as to be one pixel before the top left of the current character.</p>\n<p>Note that the root item of the delegate component must be a <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qquickitem.html\">QQuickItem</a> or <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qquickitem.html\">QQuickItem</a> derived item.</p>\n</div></div><!-- @@@cursorDelegate -->\n<br/>\n<!-- $$$cursorPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorPosition-prop\"></a><span class=\"name\">cursorPosition</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the cursor in the TextArea.</p>\n</div></div><!-- @@@cursorPosition -->\n<br/>\n<!-- $$$cursorRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorRectangle-prop\"></a><span class=\"name\">cursorRectangle</span> : <span class=\"type\">rectangle</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The rectangle where the standard text cursor is rendered within the text edit. Read-only.</p>\n<p>The position and height of a custom <a href=\"#cursorDelegate-prop\">cursorDelegate</a> are updated to follow the cursorRectangle automatically when it changes. The width of the delegate is unaffected by changes in the cursor rectangle.</p>\n</div></div><!-- @@@cursorRectangle -->\n<br/>\n<!-- $$$cursorVisible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorVisible-prop\"></a><span class=\"name\">cursorVisible</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>If true the text edit shows a cursor.</p>\n<p>This property is set and unset when the text edit gets active focus, but it can also be set directly (useful, for example, if a KeyProxy might forward keys to it).</p>\n</div></div><!-- @@@cursorVisible -->\n<br/>\n<!-- $$$displayText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"displayText-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">displayText</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property contains the text that is displayed on the screen. May differ from the text property value when <a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.RichText format is selected.</p>\n</div></div><!-- @@@displayText -->\n<br/>\n<!-- $$$effectiveHorizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"effectiveHorizontalAlignment-prop\"></a><span class=\"name\">effectiveHorizontalAlignment</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Presents the effective horizontal alignment that can be different from the one specified at <a href=\"#horizontalAlignment-prop\">horizontalAlignment</a> due to layout mirroring.</p>\n</div></div><!-- @@@effectiveHorizontalAlignment -->\n<br/>\n<!-- $$$font -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"font-prop\"></a><span class=\"name\">font</span> : <span class=\"type\"><a href=\"#font-prop\">font</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the font used by the editing.</p>\n</div></div><!-- @@@font -->\n<br/>\n<!-- $$$highlighted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"highlighted-prop\"></a><span class=\"name\">highlighted</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property presents whether the TextArea is highlighted or not. By default the TextArea gets highlighted when gets the focus, so can accept text input. This property allows to control the highlight separately from the focused behavior.</p>\n</div></div><!-- @@@highlighted -->\n<br/>\n<!-- $$$horizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"horizontalAlignment-prop\"></a><span class=\"name\">horizontalAlignment</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the horizontal alignment of the text within the TextAre item's width and height. By default, the text alignment follows the natural alignment of the text, for example text that is read from left to right will be aligned to the left.</p>\n<p>Valid values for <a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a> are:</p>\n<ul>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignLeft (default)</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignRight</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignHCenter</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignJustify</li>\n</ul>\n</div></div><!-- @@@horizontalAlignment -->\n<br/>\n<!-- $$$inputMethodComposing -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodComposing-prop\"></a><span class=\"name\">inputMethodComposing</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds whether the TextArea has partial text input from an input method.</p>\n<p>While it is composing an input method may rely on mouse or key events from the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a> to edit or commit the partial text. This property can be used to determine when to disable events handlers that may interfere with the correct operation of an input method.</p>\n</div></div><!-- @@@inputMethodComposing -->\n<br/>\n<!-- $$$inputMethodHints -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodHints-prop\"></a><span class=\"name\">inputMethodHints</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides hints to the input method about the expected content of the text edit and how it should operate.</p>\n<p>The value is a bit-wise combination of flags or Qt.ImhNone if no hints are set.</p>\n<p>Flags that alter behaviour are:</p>\n<ul>\n<li>Qt.ImhHiddenText - Characters should be hidden, as is typically used when entering passwords.</li>\n<li>Qt.ImhSensitiveData - Typed text should not be stored by the active input method in any persistent storage like predictive user dictionary.</li>\n<li>Qt.ImhNoAutoUppercase - The input method should not try to automatically switch to upper case when a sentence ends.</li>\n<li>Qt.ImhPreferNumbers - Numbers are preferred (but not required).</li>\n<li>Qt.ImhPreferUppercase - Upper case letters are preferred (but not required).</li>\n<li>Qt.ImhPreferLowercase - Lower case letters are preferred (but not required).</li>\n<li>Qt.ImhNoPredictiveText - Do not use predictive text (i.e&#x2e; dictionary lookup) while typing.</li>\n<li>Qt.ImhDate - The text editor functions as a date field.</li>\n<li>Qt.ImhTime - The text editor functions as a time field.</li>\n</ul>\n<p>Flags that restrict input (exclusive flags) are:</p>\n<ul>\n<li>Qt.ImhDigitsOnly - Only digits are allowed.</li>\n<li>Qt.ImhFormattedNumbersOnly - Only number input is allowed. This includes decimal point and minus sign.</li>\n<li>Qt.ImhUppercaseOnly - Only upper case letter input is allowed.</li>\n<li>Qt.ImhLowercaseOnly - Only lower case letter input is allowed.</li>\n<li>Qt.ImhDialableCharactersOnly - Only characters suitable for phone dialing are allowed.</li>\n<li>Qt.ImhEmailCharactersOnly - Only characters suitable for email addresses are allowed.</li>\n<li>Qt.ImhUrlCharactersOnly - Only characters suitable for URLs are allowed.</li>\n</ul>\n<p>Masks:</p>\n<ul>\n<li>Qt.ImhExclusiveInputMask - This mask yields nonzero if any of the exclusive flags are used.</li>\n</ul>\n</div></div><!-- @@@inputMethodHints -->\n<br/>\n<!-- $$$length -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"length-prop\"></a><span class=\"name\">length</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the total number of plain text characters in the TextArea item.</p>\n<p>As this number doesn't include any formatting markup it may not be the same as the length of the string returned by the text property.</p>\n<p>This property can be faster than querying the length the text property as it doesn't require any copying or conversion of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a>'s internal string data.</p>\n</div></div><!-- @@@length -->\n<br/>\n<!-- $$$lineCount -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"lineCount-prop\"></a><span class=\"name\">lineCount</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the total number of lines in the TextArea item.</p>\n</div></div><!-- @@@lineCount -->\n<br/>\n<!-- $$$maximumLineCount -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumLineCount-prop\"></a><span class=\"name\">maximumLineCount</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property holds the maximum amount of lines to expand when <a href=\"#autoSize-prop\">autoSize</a> is enabled. The value of 0 does not put any upper limit and the control will expand forever.</p>\n<p>The default value is 5 lines.</p>\n</div></div><!-- @@@maximumLineCount -->\n<br/>\n<!-- $$$mouseSelectionMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"mouseSelectionMode-prop\"></a><span class=\"name\">mouseSelectionMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies how text should be selected using a mouse.</p>\n<ul>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.SelectCharacters - The selection is updated with individual characters. (Default)</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.SelectWords - The selection is updated with whole words.</li>\n</ul>\n<p>This property only applies when <a href=\"#selectByMouse-prop\">selectByMouse</a> is true.</p>\n</div></div><!-- @@@mouseSelectionMode -->\n<br/>\n<!-- $$$persistentSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"persistentSelection-prop\"></a><span class=\"name\">persistentSelection</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the TextArea should keep the selection visible when it loses active focus to another item in the scene. By default this is set to true;</p>\n</div></div><!-- @@@persistentSelection -->\n<br/>\n<!-- $$$placeholderText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"placeholderText-prop\"></a><span class=\"name\">placeholderText</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Text that appears when there is no focus and no content in the component (hint text).</p>\n</div></div><!-- @@@placeholderText -->\n<br/>\n<!-- $$$popover -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"popover-prop\"></a><span class=\"name\">popover</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-var.html\">var</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property overrides the default popover of the TextArea. When set, the TextArea will open the given popover instead of the default one defined. The popover can either be a component or a URL to be loaded.</p>\n</div></div><!-- @@@popover -->\n<br/>\n<!-- $$$readOnly -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"readOnly-prop\"></a><span class=\"name\">readOnly</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the user can interact with the TextArea item. If this property is set to true the text cannot be edited by user interaction.</p>\n<p>By default this property is false.</p>\n</div></div><!-- @@@readOnly -->\n<br/>\n<!-- $$$renderType -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"renderType-prop\"></a><span class=\"name\">renderType</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Override the default rendering type for this component.</p>\n<p>Supported render types are:</p>\n<ul>\n<li>Text.QtRendering - the default</li>\n<li>Text.NativeRendering</li>\n</ul>\n<p>Select Text.NativeRendering if you prefer text to look native on the target platform and do not require advanced features such as transformation of the text. Using such features in combination with the NativeRendering render type will lend poor and sometimes pixelated results.</p>\n</div></div><!-- @@@renderType -->\n<br/>\n<!-- $$$selectByMouse -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectByMouse-prop\"></a><span class=\"name\">selectByMouse</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property drives whether text selection should happen with the mouse or not. The default value is true.</p>\n</div></div><!-- @@@selectByMouse -->\n<br/>\n<!-- $$$selectedText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedText-prop\"></a><span class=\"name\">selectedText</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This read-only property provides the text currently selected in the text edit.</p>\n</div></div><!-- @@@selectedText -->\n<br/>\n<!-- $$$selectedTextColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedTextColor-prop\"></a><span class=\"name\">selectedTextColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The selected text color, used in selections.</p>\n</div></div><!-- @@@selectedTextColor -->\n<br/>\n<!-- $$$selectionColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionColor-prop\"></a><span class=\"name\">selectionColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text highlight color, used behind selections.</p>\n</div></div><!-- @@@selectionColor -->\n<br/>\n<!-- $$$selectionEnd -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionEnd-prop\"></a><span class=\"name\">selectionEnd</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position after the last character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start, end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n<p>See also <a href=\"#selectionStart-prop\">selectionStart</a>, <a href=\"#cursorPosition-prop\">cursorPosition</a>, and <a href=\"#selectedText-prop\">selectedText</a>.</p>\n</div></div><!-- @@@selectionEnd -->\n<br/>\n<!-- $$$selectionStart -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionStart-prop\"></a><span class=\"name\">selectionStart</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position before the first character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start, end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n<p>See also <a href=\"#selectionEnd-prop\">selectionEnd</a>, <a href=\"#cursorPosition-prop\">cursorPosition</a>, and <a href=\"#selectedText-prop\">selectedText</a>.</p>\n</div></div><!-- @@@selectionStart -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text to display. If the text format is AutoText the text edit will automatically determine whether the text should be treated as rich text. This determination is made using Qt::mightBeRichText().</p>\n</div></div><!-- @@@text -->\n<br/>\n<!-- $$$textFormat -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"textFormat-prop\"></a><span class=\"name\">textFormat</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The way the text property should be displayed.</p>\n<ul>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AutoText</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.PlainText</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.RichText</li>\n</ul>\n<p>The default is <a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.PlainText. If the text format is <a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AutoText the text edit will automatically determine whether the text should be treated as rich text. This determination is made using Qt::mightBeRichText().</p>\n</div></div><!-- @@@textFormat -->\n<br/>\n<!-- $$$verticalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"verticalAlignment-prop\"></a><span class=\"name\">verticalAlignment</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the vertical alignment of the text within the TextAres item's width and height. By default, the text alignment follows the natural alignment of the text.</p>\n<p>Valid values for verticalAlignment are:</p>\n<ul>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignTop (default)</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignBottom</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.AlignVCenter</li>\n</ul>\n</div></div><!-- @@@verticalAlignment -->\n<br/>\n<!-- $$$wrapMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"wrapMode-prop\"></a><span class=\"name\">wrapMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Set this property to wrap the text to the <a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a> item's width. The text will only wrap if an explicit width has been set.</p>\n<ul>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.NoWrap - no wrapping will be performed. If the text contains insufficient newlines, then implicitWidth will exceed a set width.</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.WordWrap - wrapping is done on word boundaries only. If a word is too long, implicitWidth will exceed a set width.</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.WrapAnywhere - wrapping is done at any point on a line, even if it occurs in the middle of a word.</li>\n<li><a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.Wrap - if possible, wrapping occurs at a word boundary; otherwise it will occur at the appropriate point on the line, even in the middle of a word.</li>\n</ul>\n<p>The default is <a href=\"/api/qml/sdk-14.04/QtQuick.TextEdit\">TextEdit</a>.Wrap</p>\n</div></div><!-- @@@wrapMode -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$linkActivated -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"linkActivated-signal\"></a>TextArea::<span class=\"name\">linkActivated</span>(<span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span><i> link</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when the user clicks on a link embedded in the text. The link must be in rich text or HTML format and the link string provides access to the particular link.</p>\n</div></div><!-- @@@linkActivated -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$copy -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"copy-method\"></a>TextArea::<span class=\"name\">copy</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Copies the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@copy -->\n<br/>\n<!-- $$$cut -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"cut-method\"></a>TextArea::<span class=\"name\">cut</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@cut -->\n<br/>\n<!-- $$$deselect -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"deselect-method\"></a>TextArea::<span class=\"name\">deselect</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes active text selection.</p>\n</div></div><!-- @@@deselect -->\n<br/>\n<!-- $$$getFormattedText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"getFormattedText-method\"></a>TextArea::<span class=\"name\">getFormattedText</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the section of text that is between the start and end positions.</p>\n<p>The returned text will be formatted according the <a href=\"#textFormat-prop\">textFormat</a> property.</p>\n</div></div><!-- @@@getFormattedText -->\n<br/>\n<!-- $$$getText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"getText-method\"></a>TextArea::<span class=\"name\">getText</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the section of text that is between the start and end positions.</p>\n<p>The returned text does not include any rich text formatting. A getText(0, length) will result in the same value as <a href=\"#displayText-prop\">displayText</a>.</p>\n</div></div><!-- @@@getText -->\n<br/>\n<!-- $$$insert -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"insert-method\"></a>TextArea::<span class=\"name\">insert</span>(<i> position</i>, <i> text</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Inserts text into the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a> at position.</p>\n</div></div><!-- @@@insert -->\n<br/>\n<!-- $$$isRightToLeft -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"isRightToLeft-method\"></a>TextArea::<span class=\"name\">isRightToLeft</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the natural reading direction of the editor text found between positions start and end is right to left.</p>\n</div></div><!-- @@@isRightToLeft -->\n<br/>\n<!-- $$$moveCursorSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"moveCursorSelection-method\"></a>TextArea::<span class=\"name\">moveCursorSelection</span>(<i> position</i>, <i> mode</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the cursor to position and updates the selection according to the optional mode parameter. (To only move the cursor, set the <a href=\"#cursorPosition-prop\">cursorPosition</a> property.)</p>\n<p>When this method is called it additionally sets either the <a href=\"#selectionStart-prop\">selectionStart</a> or the <a href=\"#selectionEnd-prop\">selectionEnd</a> (whichever was at the previous cursor position) to the specified position. This allows you to easily extend and contract the selected text range.</p>\n<p>The selection mode specifies whether the selection is updated on a per character or a per word basis. If not specified the selection mode will default to whatever is given in the <a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a> property.</p>\n</div></div><!-- @@@moveCursorSelection -->\n<br/>\n<!-- $$$paste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"paste-method\"></a>TextArea::<span class=\"name\">paste</span>(<i> data</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Places the clipboard or the data given as parameter into the text input. The selected text will be replaces with the data.</p>\n</div></div><!-- @@@paste -->\n<br/>\n<!-- $$$positionAt -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionAt-method\"></a>TextArea::<span class=\"name\">positionAt</span>(<i> x</i>, <i> y</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the text position closest to pixel position (x, y).</p>\n<p>Position 0 is before the first character, position 1 is after the first character but before the second, and so on until position text.length, which is after all characters.</p>\n</div></div><!-- @@@positionAt -->\n<br/>\n<!-- $$$positionToRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionToRectangle-method\"></a>TextArea::<span class=\"name\">positionToRectangle</span>(<i> position</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the rectangle at the given position in the text. The x, y, and height properties correspond to the cursor that would describe that position.</p>\n</div></div><!-- @@@positionToRectangle -->\n<br/>\n<!-- $$$redo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"redo-method\"></a>TextArea::<span class=\"name\">redo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Redoes the last operation if redo is <a href=\"#canRedo-prop\">available</a>.</p>\n</div></div><!-- @@@redo -->\n<br/>\n<!-- $$$remove -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"remove-method\"></a>TextArea::<span class=\"name\">remove</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes the section of text that is between the start and end positions from the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextArea\">TextArea</a>.</p>\n</div></div><!-- @@@remove -->\n<br/>\n<!-- $$$select -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"select-method\"></a>TextArea::<span class=\"name\">select</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the text from start to end to be selected.</p>\n<p>If either start or end is out of range, the selection is not changed.</p>\n<p>After calling this, <a href=\"#selectionStart-prop\">selectionStart</a> will become the lesser and <a href=\"#selectionEnd-prop\">selectionEnd</a> will become the greater (regardless of the order passed to this method).</p>\n<p>See also <a href=\"#selectionStart-prop\">selectionStart</a> and <a href=\"#selectionEnd-prop\">selectionEnd</a>.</p>\n</div></div><!-- @@@select -->\n<br/>\n<!-- $$$selectAll -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectAll-method\"></a>TextArea::<span class=\"name\">selectAll</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes all text to be selected.</p>\n</div></div><!-- @@@selectAll -->\n<br/>\n<!-- $$$selectWord -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectWord-method\"></a>TextArea::<span class=\"name\">selectWord</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the word closest to the current cursor position to be selected.</p>\n</div></div><!-- @@@selectWord -->\n<br/>\n<!-- $$$undo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"undo-method\"></a>TextArea::<span class=\"name\">undo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Undoes the last operation if undo is <a href=\"#canUndo-prop\">available</a>. Deselects any current selection, and updates the selection start to the current cursor position.</p>\n</div></div><!-- @@@undo -->\n<br/>\n</div></div>\n", "source_file": "qml-ubuntu-components0-textarea.html", "source_format": "qdoc" }, { "url": "http://developer.ubuntu.com/api/service/elements/196/", "name": "TextField", "description": "The TextField element displays a single line of editable plain text. Input constraints can be set through validator or <a href=\"#inputMask-prop\">inputMask</a>. Setting <a href=\"#echoMode-prop\">echoMode</a> to an appropriate value enables TextField to b...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/7/", "section": "http://developer.ubuntu.com/api/service/sections/2/", "fullname": "Ubuntu.Components.TextField", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$TextField-brief -->\n<p>The TextField element displays a single line of editable plain text. Input constraints can be set through validator or <a href=\"#inputMask-prop\">inputMask</a>. Setting <a href=\"#echoMode-prop\">echoMode</a> to an appropriate value enables TextField to be used as password input field. <a href=\"#details\">More...</a></p>\n<!-- @@@TextField -->\n<p>Inherits <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.StyledItem/\">StyledItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#acceptableInput-prop\">acceptableInput</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#activeFocusOnPress-prop\">activeFocusOnPress</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#autoScroll-prop\">autoScroll</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canPaste-prop\">canPaste</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canRedo-prop\">canRedo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canUndo-prop\">canUndo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#contentHeight-prop\">contentHeight</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#contentWidth-prop\">contentWidth</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#cursorDelegate-prop\">cursorDelegate</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#cursorPosition-prop\">cursorPosition</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#cursorRectangle-prop\">cursorRectangle</a></b></b> : rectangle</li>\n<li class=\"fn\"><b><b><a href=\"#cursorVisible-prop\">cursorVisible</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#customSoftwareInputPanel-prop\">customSoftwareInputPanel</a></b></b> : Component<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#displayText-prop\">displayText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#echoMode-prop\">echoMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#errorHighlight-prop\">errorHighlight</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#font-prop\">font</a></b></b> : font</li>\n<li class=\"fn\"><b><b><a href=\"#hasClearButton-prop\">hasClearButton</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#highlighted-prop\">highlighted</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#horizontalAlignment-prop\">horizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#inputMask-prop\">inputMask</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodComposing-prop\">inputMethodComposing</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodHints-prop\">inputMethodHints</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#length-prop\">length</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#maximumLength-prop\">maximumLength</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#passwordCharacter-prop\">passwordCharacter</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#persistentSelection-prop\">persistentSelection</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#placeholderText-prop\">placeholderText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#popover-prop\">popover</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#primaryItem-prop\">primaryItem</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#readOnly-prop\">readOnly</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#renderType-prop\">renderType</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#secondaryItem-prop\">secondaryItem</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#selctedTextColor-prop\">selctedTextColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectByMouse-prop\">selectByMouse</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#selectedText-prop\">selectedText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#selectionColor-prop\">selectionColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionEnd-prop\">selectionEnd</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#selectionStart-prop\">selectionStart</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#validator-prop\">validator</a></b></b> : Validator</li>\n<li class=\"fn\"><b><b><a href=\"#verticalAlignment-prop\">verticalAlignment</a></b></b> : enumeration</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#accepted-signal\">accepted</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#copy-method\">copy</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#cut-method\">cut</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#deselect-method\">deselect</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#getText-method\">getText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#insert-method\">insert</a></b></b>(<i>position</i>, <i>text</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#isRightToLeft-method\">isRightToLeft</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#moveCursorSelection-method\">moveCursorSelection</a></b></b>(<i>position</i>, <i>mode</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#paste-method\">paste</a></b></b>(<i>data</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionAt-method\">positionAt</a></b></b>(<i>x</i>, <i>position</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionToRectangle-method\">positionToRectangle</a></b></b>(<i>pos</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#redo-method\">redo</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#remove-method\">remove</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#select-method\">select</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#selectAll-method\">selectAll</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#selectWord-method\">selectWord</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#undo-method\">undo</a></b></b>()</li>\n</ul>\n<!-- $$$TextField-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/text-field\">See also the Design Guidelines on the Text Field</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\">Item</span> {\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;hint text&quot;</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;without clear sign&quot;</span>\n <span class=\"name\">hasClearButton</span>: <span class=\"number\">false</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;password&quot;</span>\n <span class=\"name\">echoMode</span>: <span class=\"name\">TextInput</span>.<span class=\"name\">Password</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;overlaid in front&quot;</span>\n <span class=\"name\">primaryItem</span>: <span class=\"name\">Image</span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">source</span>: <span class=\"string\">&quot;magnifier.png&quot;</span>\n }\n <span class=\"name\">secondaryItem</span>: <span class=\"name\">Row</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;caps-lock.png&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">doSomething</span>()\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.Button/\">Button</a></span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">iconSource</span>: <span class=\"string\">&quot;num-lock.png&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">doSomething</span>()\n }\n }\n }\n}</pre>\n<!-- @@@TextField -->\n<h2>Property Documentation</h2>\n<!-- $$$acceptableInput -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"acceptableInput-prop\"></a><span class=\"name\">acceptableInput</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property is always true unless a validator or input mask has been set. If a validator or input mask has been set, this property will only be true if the current text is acceptable to the validator or input mask as a final string (not as an intermediate string).</p>\n</div></div><!-- @@@acceptableInput -->\n<br/>\n<!-- $$$activeFocusOnPress -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"activeFocusOnPress-prop\"></a><span class=\"name\">activeFocusOnPress</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> should gain active focus on a mouse press. By default this is set to true.</p>\n</div></div><!-- @@@activeFocusOnPress -->\n<br/>\n<!-- $$$autoScroll -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoScroll-prop\"></a><span class=\"name\">autoScroll</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> should scroll when the text is longer than the width. By default this is set to true.</p>\n</div></div><!-- @@@autoScroll -->\n<br/>\n<!-- $$$canPaste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canPaste-prop\"></a><span class=\"name\">canPaste</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> is writable and the content of the clipboard is suitable for pasting into the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@canPaste -->\n<br/>\n<!-- $$$canRedo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canRedo-prop\"></a><span class=\"name\">canRedo</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> is writable and there are undone operations that can be redone.</p>\n</div></div><!-- @@@canRedo -->\n<br/>\n<!-- $$$canUndo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canUndo-prop\"></a><span class=\"name\">canUndo</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> is writable and there are previous operations that can be undone.</p>\n</div></div><!-- @@@canUndo -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text color.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$contentHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentHeight-prop\"></a><span class=\"name\">contentHeight</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the height of the text, including the height past the height that is covered if the text does not fit within the set height.</p>\n</div></div><!-- @@@contentHeight -->\n<br/>\n<!-- $$$contentWidth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentWidth-prop\"></a><span class=\"name\">contentWidth</span> : <span class=\"type\">real</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the width of the text, including the width past the width which is covered due to insufficient wrapping if wrapMode is set.</p>\n</div></div><!-- @@@contentWidth -->\n<br/>\n<!-- $$$cursorDelegate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorDelegate-prop\"></a><span class=\"name\">cursorDelegate</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The delegate for the cursor in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<p>If you set a cursorDelegate for a <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>, this delegate will be used for drawing the cursor instead of the standard cursor. An instance of the delegate will be created and managed by the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> when a cursor is needed, and the x property of delegate instance will be set so as to be one pixel before the top left of the current character.</p>\n<p>Note that the root item of the delegate component must be a QQuickItem or QQuickItem derived item.</p>\n</div></div><!-- @@@cursorDelegate -->\n<br/>\n<!-- $$$cursorPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorPosition-prop\"></a><span class=\"name\">cursorPosition</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the cursor in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@cursorPosition -->\n<br/>\n<!-- $$$cursorRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorRectangle-prop\"></a><span class=\"name\">cursorRectangle</span> : <span class=\"type\">rectangle</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The rectangle where the standard text cursor is rendered within the text input. Read only.</p>\n<p>The position and height of a custom <a href=\"#cursorDelegate-prop\">cursorDelegate</a> are updated to follow the cursorRectangle automatically when it changes. The width of the delegate is unaffected by changes in the cursor rectangle.</p>\n</div></div><!-- @@@cursorRectangle -->\n<br/>\n<!-- $$$cursorVisible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorVisible-prop\"></a><span class=\"name\">cursorVisible</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Set to true when the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> shows a cursor.</p>\n<p>This property is set and unset when the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> gets active focus, so that other properties can be bound to whether the cursor is currently showing. As it gets set and unset automatically, when you set the value yourself you must keep in mind that your value may be overwritten.</p>\n<p>It can be set directly in script, for example if a KeyProxy might forward keys to it and you desire it to look active when this happens (but without actually giving it active focus).</p>\n<p>It should not be set directly on the item, like in the below QML, as the specified value will be overridden an lost on focus changes.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Text&quot;</span>\n <span class=\"name\">cursorVisible</span>: <span class=\"number\">false</span>\n}</pre>\n<p>In the above snippet the cursor will still become visible when the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> gains active focus.</p>\n</div></div><!-- @@@cursorVisible -->\n<br/>\n<!-- $$$customSoftwareInputPanel -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"customSoftwareInputPanel-prop\"></a><span class=\"name\">customSoftwareInputPanel</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Component to be shown and used instead of the default On Screen Keyboard.</p>\n</div></div><!-- @@@customSoftwareInputPanel -->\n<br/>\n<!-- $$$displayText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"displayText-prop\"></a><span class=\"name\">displayText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This is the text displayed in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<p>If <a href=\"#echoMode-prop\">echoMode</a> is set to TextInput::Normal, this holds the same value as the <a href=\"#text-prop\">text</a> property. Otherwise, this property holds the text visible to the user, while the text property holds the actual entered text.</p>\n</div></div><!-- @@@displayText -->\n<br/>\n<!-- $$$echoMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"echoMode-prop\"></a><span class=\"name\">echoMode</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies how the text should be displayed in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<ul>\n<li>- TextInput.Normal - Displays the text as it is. (Default)</li>\n<li>- TextInput.Password - Displays asterixes instead of characters.</li>\n<li>- TextInput.NoEcho - Displays nothing.</li>\n<li>- TextInput.PasswordEchoOnEdit - Displays characters as they are entered while editing, otherwise displays asterisks.</li>\n</ul>\n</div></div><!-- @@@echoMode -->\n<br/>\n<!-- $$$errorHighlight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"errorHighlight-prop\"></a><span class=\"name\">errorHighlight</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Allows highlighting errors in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@errorHighlight -->\n<br/>\n<!-- $$$font -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"font-prop\"></a><span class=\"name\">font</span> : <span class=\"type\"><a href=\"#font-prop\">font</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Font used in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@font -->\n<br/>\n<!-- $$$hasClearButton -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hasClearButton-prop\"></a><span class=\"name\">hasClearButton</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies whether the control has a clear button or not.</p>\n</div></div><!-- @@@hasClearButton -->\n<br/>\n<!-- $$$highlighted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"highlighted-prop\"></a><span class=\"name\">highlighted</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property presents whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> is highlighted or not. By default the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> gets highlighted when gets the focus, so can accept text input. This property allows to control the highlight separately from the focused behavior.</p>\n</div></div><!-- @@@highlighted -->\n<br/>\n<!-- $$$horizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"horizontalAlignment-prop\"></a><span class=\"name\">horizontalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"effectiveHorizontalAlignment-prop\"></a><span class=\"name\">effectiveHorizontalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"verticalAlignment-prop\"></a><span class=\"name\">verticalAlignment</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the horizontal alignment of the text within the item's width and height. By default, the text alignment follows the natural alignment of the text, for example text that is read from left to right will be aligned to the left.</p>\n<p><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> does not have vertical alignment, as the natural height is exactly the height of the single line of text. If you set the height manually to something larger, TextInput will always be top aligned vertically. You can use anchors to align it however you want within another item.</p>\n<p>The valid values for horizontalAlignment are TextInput.AlignLeft, TextInput.AlignRight and TextInput.AlignHCenter.</p>\n<p>Valid values for verticalAlignment are TextInput.AlignTop (default), TextInput.AlignBottom TextInput.AlignVCenter.</p>\n<p>When using the attached property LayoutMirroring::enabled to mirror application layouts, the horizontal alignment of text will also be mirrored. However, the property horizontalAlignment will remain unchanged. To query the effective horizontal alignment of <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>, use the read-only property effectiveHorizontalAlignment.</p>\n</div></div><!-- @@@horizontalAlignment -->\n<br/>\n<!-- $$$inputMask -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMask-prop\"></a><span class=\"name\">inputMask</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Allows you to set an input mask on the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>, restricting the text inputs. See QLineEdit::inputMask for further details, as the exact same mask strings are used by <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@inputMask -->\n<br/>\n<!-- $$$inputMethodComposing -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodComposing-prop\"></a><span class=\"name\">inputMethodComposing</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds whether the TextInput has partial text input from an input method.</p>\n<p>While it is composing an input method may rely on mouse or key events from the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> to edit or commit the partial text. This property can be used to determine when to disable events handlers that may interfere with the correct operation of an input method.</p>\n</div></div><!-- @@@inputMethodComposing -->\n<br/>\n<!-- $$$inputMethodHints -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodHints-prop\"></a><span class=\"name\">inputMethodHints</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides hints to the input method about the expected content of the text input and how it should operate.</p>\n<p>The value is a bit-wise combination of flags, or Qt.ImhNone if no hints are set.</p>\n<p>Flags that alter behaviour are:</p>\n<ul>\n<li>- Qt.ImhHiddenText - Characters should be hidden, as is typically used when entering passwords. This is automatically set when setting <a href=\"#echoMode-prop\">echoMode</a> to <tt>TextInput.Password</tt>.</li>\n<li>- Qt.ImhSensitiveData - Typed text should not be stored by the active input method in any persistent storage like predictive user dictionary.</li>\n<li>- Qt.ImhNoAutoUppercase - The input method should not try to automatically switch to upper case when a sentence ends.</li>\n<li>- Qt.ImhPreferNumbers - Numbers are preferred (but not required).</li>\n<li>- Qt.ImhPreferUppercase - Upper case letters are preferred (but not required).</li>\n<li>- Qt.ImhPreferLowercase - Lower case letters are preferred (but not required).</li>\n<li>- Qt.ImhNoPredictiveText - Do not use predictive text (i.e&#x2e; dictionary lookup) while typing.</li>\n<li>- Qt.ImhDate - The text editor functions as a date field.</li>\n<li>- Qt.ImhTime - The text editor functions as a time field.</li>\n</ul>\n<p>Flags that restrict input (exclusive flags) are:</p>\n<ul>\n<li>- Qt.ImhDigitsOnly - Only digits are allowed.</li>\n<li>- Qt.ImhFormattedNumbersOnly - Only number input is allowed. This includes decimal point and minus sign.</li>\n<li>- Qt.ImhUppercaseOnly - Only upper case letter input is allowed.</li>\n<li>- Qt.ImhLowercaseOnly - Only lower case letter input is allowed.</li>\n<li>- Qt.ImhDialableCharactersOnly - Only characters suitable for phone dialing are allowed.</li>\n<li>- Qt.ImhEmailCharactersOnly - Only characters suitable for email addresses are allowed.</li>\n<li>- Qt.ImhUrlCharactersOnly - Only characters suitable for URLs are allowed.</li>\n</ul>\n<p>Masks:</p>\n<ul>\n<li>- Qt.ImhExclusiveInputMask - This mask yields nonzero if any of the exclusive flags are used.</li>\n</ul>\n</div></div><!-- @@@inputMethodHints -->\n<br/>\n<!-- $$$length -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"length-prop\"></a><span class=\"name\">length</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the total number of characters in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> item.</p>\n<p>If the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> has an <a href=\"#inputMask-prop\">inputMask</a> the length will include mask characters and may differ from the length of the string returned by the text property.</p>\n<p>This property can be faster than querying the length the text property as it doesn't require any copying or conversion of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>'s internal string data.</p>\n</div></div><!-- @@@length -->\n<br/>\n<!-- $$$maximumLength -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"maximumLength-prop\"></a><span class=\"name\">maximumLength</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The maximum permitted length of the text in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<p>If the text is too long, it is truncated at the limit.</p>\n<p>By default, this property contains a value of 32767.</p>\n</div></div><!-- @@@maximumLength -->\n<br/>\n<!-- $$$mouseSelectionMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"mouseSelectionMode-prop\"></a><span class=\"name\">mouseSelectionMode</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies how text should be selected using a mouse.</p>\n<ul>\n<li>-TextInput.SelectCharacters - The selection is updated with individual characters. (Default)</li>\n<li>-TextInput.SelectWords - The selection is updated with whole words.</li>\n</ul>\n<p>This property only applies when <a href=\"#selectByMouse-prop\">selectByMouse</a> is true.</p>\n</div></div><!-- @@@mouseSelectionMode -->\n<br/>\n<!-- $$$passwordCharacter -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"passwordCharacter-prop\"></a><span class=\"name\">passwordCharacter</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This is the character displayed when <a href=\"#echoMode-prop\">echoMode</a> is set to Password or PasswordEchoOnEdit. By default it is the unicode character 2022.</p>\n<p>If this property is set to a string with more than one character, the first character is used. If the string is empty, the value is ignored and the property is not set.</p>\n</div></div><!-- @@@passwordCharacter -->\n<br/>\n<!-- $$$persistentSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"persistentSelection-prop\"></a><span class=\"name\">persistentSelection</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> should keep its selection when it loses active focus to another item in the scene. By default this is set to false.</p>\n</div></div><!-- @@@persistentSelection -->\n<br/>\n<!-- $$$placeholderText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"placeholderText-prop\"></a><span class=\"name\">placeholderText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Text that appears when there is no focus and no content in the component.</p>\n</div></div><!-- @@@placeholderText -->\n<br/>\n<!-- $$$popover -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"popover-prop\"></a><span class=\"name\">popover</span> : <span class=\"type\">var</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property overrides the default popover of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>. When set, the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> will open the given popover instead of the defaul tone defined. The popover can either be a component or a URL to be loaded.</p>\n</div></div><!-- @@@popover -->\n<br/>\n<!-- $$$primaryItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"primaryItem-prop\"></a><span class=\"name\">primaryItem</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">Object</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Overlaid component that can be set for the fore side of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>, e.g&#x2e;showing a magnifier to implement search functionality.</p>\n</div></div><!-- @@@primaryItem -->\n<br/>\n<!-- $$$readOnly -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"readOnly-prop\"></a><span class=\"name\">readOnly</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets whether user input can modify the contents of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n<p>If readOnly is set to true, then user input will not affect the text property. Any bindings or attempts to set the text property will still work.</p>\n</div></div><!-- @@@readOnly -->\n<br/>\n<!-- $$$renderType -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"renderType-prop\"></a><span class=\"name\">renderType</span> : <span class=\"type\">enumeration</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Override the default rendering type for this component.</p>\n<p>Supported render types are:</p>\n<ul>\n<li>- Text.QtRendering - (default)</li>\n<li>- Text.NativeRendering</li>\n</ul>\n<p>Select Text.NativeRendering if you prefer text to look native on the target platform and do not require advanced features such as transformation of the text. Using such features in combination with the NativeRendering render type will lend poor and sometimes pixelated results.</p>\n</div></div><!-- @@@renderType -->\n<br/>\n<!-- $$$secondaryItem -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"secondaryItem-prop\"></a><span class=\"name\">secondaryItem</span> : <span class=\"type\">list</span>&lt;<span class=\"type\">Object</span>&gt;</p></td></tr></table></div><div class=\"qmldoc\"><p>Overlaid component that can be set for the rear side of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>, e.g&#x2e;showing a CAPS LOCK or NUM LOCK indication. The overlaid components will be placed right after the clear button.</p>\n</div></div><!-- @@@secondaryItem -->\n<br/>\n<!-- $$$selectByMouse -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectByMouse-prop\"></a><span class=\"name\">selectByMouse</span> : <span class=\"type\">bool</span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Defaults to true.</p>\n<p>If false, the user cannot use the mouse to select text, only can use it to focus the input.</p>\n</div></div><!-- @@@selectByMouse -->\n<br/>\n<!-- $$$selectedText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectedText-prop\"></a><span class=\"qmlreadonly\">read-only</span><span class=\"name\">selectedText</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>This read-only property provides the text currently selected in the text input.</p>\n<p>It is equivalent to the following snippet, but is faster and easier to use.</p>\n<pre class=\"cpp\">myTextInput<span class=\"operator\">.</span>text<span class=\"operator\">.</span>toString()<span class=\"operator\">.</span>substring(myTextInput<span class=\"operator\">.</span>selectionStart<span class=\"operator\">,</span>\n myTextInput<span class=\"operator\">.</span>selectionEnd);</pre>\n</div></div><!-- @@@selectedText -->\n<br/>\n<!-- $$$selectedTextColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selctedTextColor-prop\"></a><span class=\"name\">selctedTextColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The highlighted text color, used in selections.</p>\n</div></div><!-- @@@selectedTextColor -->\n<br/>\n<!-- $$$selectionColor -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionColor-prop\"></a><span class=\"name\">selectionColor</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text highlight color, used behind selections.</p>\n</div></div><!-- @@@selectionColor -->\n<br/>\n<!-- $$$selectionEnd -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionEnd-prop\"></a><span class=\"name\">selectionEnd</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position after the last character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start,end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n</div></div><!-- @@@selectionEnd -->\n<br/>\n<!-- $$$selectionStart -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"selectionStart-prop\"></a><span class=\"name\">selectionStart</span> : <span class=\"type\">int</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The cursor position before the first character in the current selection.</p>\n<p>This property is read-only. To change the selection, use select(start,end), <a href=\"#selectAll-method\">selectAll()</a>, or <a href=\"#selectWord-method\">selectWord()</a>.</p>\n</div></div><!-- @@@selectionStart -->\n<br/>\n<!-- $$$style -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"style-prop\"></a><span class=\"name\">style</span> : <span class=\"type\">Component</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Component instantiated immediately and placed below everything else.</p>\n</div></div><!-- @@@style -->\n<br/>\n<!-- $$$text -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"text-prop\"></a><span class=\"name\">text</span> : <span class=\"type\">string</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text in the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@text -->\n<br/>\n<!-- $$$validator -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"validator-prop\"></a><span class=\"name\">validator</span> : <span class=\"type\">Validator</span></p></td></tr></table></div><div class=\"qmldoc\"><p>Allows you to set a validator on the TextInput. When a validator is set the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> will only accept input which leaves the text property in an acceptable or intermediate state. The accepted signal will only be sent if the text is in an acceptable state when enter is pressed.</p>\n<p>Currently supported validators are IntValidator, DoubleValidator and RegExpValidator. An example of using validators is shown below, which allows input of integers between 11 and 31 into the text input:</p>\n<pre class=\"qml\">import QtQuick 2.0\nimport Ubuntu.Components 0.1\n<span class=\"type\"><a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a></span>{\n <span class=\"name\">validator</span>: <span class=\"name\">IntValidator</span>{<span class=\"name\">bottom</span>: <span class=\"number\">11</span>; <span class=\"name\">top</span>: <span class=\"number\">31</span>;}\n <span class=\"name\">focus</span>: <span class=\"number\">true</span>\n}</pre>\n<p><b>See also </b><a href=\"#acceptableInput-prop\">acceptableInput</a> and <a href=\"#inputMask-prop\">inputMask</a>.</p>\n</div></div><!-- @@@validator -->\n<br/>\n<h2>Signal Documentation</h2>\n<!-- $$$accepted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"accepted-signal\"></a>TextField::<span class=\"name\">accepted</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>This handler is called when the Return or Enter key is pressed. Note that if there is a validator or <a href=\"#inputMask-prop\">inputMask</a> set on the text input, the handler will only be emitted if the input is in an acceptable state.</p>\n</div></div><!-- @@@accepted -->\n<br/>\n<h2>Method Documentation</h2>\n<!-- $$$copy -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"copy-method\"></a>TextField::<span class=\"name\">copy</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Copies the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@copy -->\n<br/>\n<!-- $$$cut -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"cut-method\"></a>TextField::<span class=\"name\">cut</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the currently selected text to the system clipboard.</p>\n</div></div><!-- @@@cut -->\n<br/>\n<!-- $$$deselect -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"deselect-method\"></a>TextField::<span class=\"name\">deselect</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes active text selection.</p>\n</div></div><!-- @@@deselect -->\n<br/>\n<!-- $$$getText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"getText-method\"></a>TextField::<span class=\"name\">getText</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the section of text that is between the start and end positions.</p>\n<p>If the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> has an <a href=\"#inputMask-prop\">inputMask</a> the length will include mask characters.</p>\n</div></div><!-- @@@getText -->\n<br/>\n<!-- $$$insert -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"insert-method\"></a>TextField::<span class=\"name\">insert</span>(<i> position</i>, <i> text</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Inserts <i>text</i> into the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a> at <i>position</i>.</p>\n</div></div><!-- @@@insert -->\n<br/>\n<!-- $$$isRightToLeft -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"isRightToLeft-method\"></a>TextField::<span class=\"name\">isRightToLeft</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the natural reading direction of the editor text found between positions start and end is right to left.</p>\n</div></div><!-- @@@isRightToLeft -->\n<br/>\n<!-- $$$moveCursorSelection -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"moveCursorSelection-method\"></a>TextField::<span class=\"name\">moveCursorSelection</span>(<i> position</i>, <i> mode</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Moves the cursor to position and updates the selection according to the optional mode parameter. (To only move the cursor, set the <a href=\"#cursorPosition-prop\">cursorPosition</a> property.)</p>\n<p>When this method is called it additionally sets either the <a href=\"#selectionStart-prop\">selectionStart</a> or the <a href=\"#selectionEnd-prop\">selectionEnd</a> (whichever was at the previous cursor position) to the specified position. This allows you to easily extend and contract the selected text range.</p>\n<p>The selection mode specifies whether the selection is updated on a per character or a per word basis. If not specified the selection mode will default to TextInput.SelectCharacters.</p>\n<ul>\n<li>- TextInput.SelectCharacters - Sets either the <a href=\"#selectionStart-prop\">selectionStart</a> or <a href=\"#selectionEnd-prop\">selectionEnd</a> (whichever was at the previous cursor position) to the specified position.</li>\n<li>- TextInput.SelectWords - Sets the <a href=\"#selectionStart-prop\">selectionStart</a> and <a href=\"#selectionEnd-prop\">selectionEnd</a> to include all words between the specified position and the previous cursor position. Words partially in the range are included.</li>\n</ul>\n<p>For example, take this sequence of calls:</p>\n<pre class=\"cpp\">cursorPosition <span class=\"operator\">=</span> <span class=\"number\">5</span>\nmoveCursorSelection(<span class=\"number\">9</span><span class=\"operator\">,</span> TextInput<span class=\"operator\">.</span>SelectCharacters)\nmoveCursorSelection(<span class=\"number\">7</span><span class=\"operator\">,</span> TextInput<span class=\"operator\">.</span>SelectCharacters)</pre>\n<p>This moves the cursor to position 5, extend the selection end from 5 to 9 and then retract the selection end from 9 to 7, leaving the text from position 5 to 7 selected (the 6th and 7th characters).</p>\n<p>The same sequence with TextInput.SelectWords will extend the selection start to a word boundary before or on position 5 and extend the selection end to a word boundary on or past position 9.</p>\n</div></div><!-- @@@moveCursorSelection -->\n<br/>\n<!-- $$$paste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"paste-method\"></a>TextField::<span class=\"name\">paste</span>(<i> data</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Places the clipboard or the data given as parameter into the text input. The selected text will be replaces with the data.</p>\n</div></div><!-- @@@paste -->\n<br/>\n<!-- $$$positionAt -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionAt-method\"></a>TextField::<span class=\"name\">positionAt</span>(<i> x</i>, <i> position</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>This function returns the character position at x pixels from the left of the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>. Position 0 is before the first character, position 1 is after the first character but before the second, and so on until position text.length, which is after all characters.</p>\n<p>This means that for all x values before the first character this function returns 0, and for all x values after the last character this function returns text.length.</p>\n<p>The cursor position type specifies how the cursor position should be resolved.</p>\n<ul>\n<li>- TextInput.CursorBetweenCharacters - Returns the position between characters that is nearest x.</li>\n<li>- TextInput.CursorOnCharacter - Returns the position before the character that is nearest x.</li>\n</ul>\n</div></div><!-- @@@positionAt -->\n<br/>\n<!-- $$$positionToRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"positionToRectangle-method\"></a>TextField::<span class=\"name\">positionToRectangle</span>(<i> pos</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>This function takes a character position and returns the rectangle that the cursor would occupy, if it was placed at that character position.</p>\n<p>This is similar to setting the <a href=\"#cursorPosition-prop\">cursorPosition</a>, and then querying the cursor rectangle, but the <a href=\"#cursorPosition-prop\">cursorPosition</a> is not changed.</p>\n</div></div><!-- @@@positionToRectangle -->\n<br/>\n<!-- $$$redo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"redo-method\"></a>TextField::<span class=\"name\">redo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Redoes the last operation if redo is <a href=\"#canRedo-prop\">available</a>.</p>\n</div></div><!-- @@@redo -->\n<br/>\n<!-- $$$remove -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"remove-method\"></a>TextField::<span class=\"name\">remove</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Removes the section of text that is between the start and end positions from the <a href=\"/api/qml/sdk-1.0/Ubuntu.Components.TextField/\">TextField</a>.</p>\n</div></div><!-- @@@remove -->\n<br/>\n<!-- $$$select -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"select-method\"></a>TextField::<span class=\"name\">select</span>(<i> start</i>, <i> end</i>)</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the text from start to end to be selected.</p>\n<p>If either start or end is out of range, the selection is not changed.</p>\n<p>After calling this, <a href=\"#selectionStart-prop\">selectionStart</a> will become the lesser and <a href=\"#selectionEnd-prop\">selectionEnd</a> will become the greater (regardless of the order passed to this method).</p>\n</div></div><!-- @@@select -->\n<br/>\n<!-- $$$selectAll -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectAll-method\"></a>TextField::<span class=\"name\">selectAll</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes all text to be selected.</p>\n</div></div><!-- @@@selectAll -->\n<br/>\n<!-- $$$selectWord -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"selectWord-method\"></a>TextField::<span class=\"name\">selectWord</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Causes the word closest to the current cursor position to be selected.</p>\n</div></div><!-- @@@selectWord -->\n<br/>\n<!-- $$$undo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlFuncNode\"><p><a name=\"undo-method\"></a>TextField::<span class=\"name\">undo</span>()</p></td></tr></table></div><div class=\"qmldoc\"><p>Undoes the last operation if undo is <a href=\"#canUndo-prop\">available</a>. Deselects any current selection, and updates the selection start to the current cursor position.</p>\n</div></div><!-- @@@undo -->\n<br/>\n", "source_file": null, "source_format": null }, { "url": "http://developer.ubuntu.com/api/service/elements/508/", "name": "TextField", "description": "The TextField element displays a single line of editable plain text. Input constraints can be set through validator or <a href=\"#inputMask-prop\">inputMask</a>. Setting <a href=\"#echoMode-prop\">echoMode</a> to an appropriate value enables TextField to b...", "namespace": "http://developer.ubuntu.com/api/service/namespaces/29/", "section": "http://developer.ubuntu.com/api/service/sections/12/", "fullname": "Ubuntu.Components.TextField", "keywords": "", "data": "<span class=\"subtitle\"></span>\n<!-- $$$TextField-brief -->\n<p>The TextField element displays a single line of editable plain text. Input constraints can be set through validator or <a href=\"#inputMask-prop\">inputMask</a>. Setting <a href=\"#echoMode-prop\">echoMode</a> to an appropriate value enables TextField to be used as password input field. <a href=\"#details\">More...</a></p>\n<!-- @@@TextField -->\n<p>Inherits <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a></p>\n<ul>\n</ul>\n<a name=\"properties\"></a>\n<h2>Properties</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#acceptableInput-prop\">acceptableInput</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#action-prop\">action</a></b></b> : Action</li>\n<li class=\"fn\"><b><b><a href=\"#activeFocusOnPress-prop\">activeFocusOnPress</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#autoScroll-prop\">autoScroll</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canPaste-prop\">canPaste</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canRedo-prop\">canRedo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#canUndo-prop\">canUndo</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#color-prop\">color</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#contentHeight-prop\">contentHeight</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#contentWidth-prop\">contentWidth</a></b></b> : real</li>\n<li class=\"fn\"><b><b><a href=\"#cursorDelegate-prop\">cursorDelegate</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#cursorPosition-prop\">cursorPosition</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#cursorRectangle-prop\">cursorRectangle</a></b></b> : rectangle</li>\n<li class=\"fn\"><b><b><a href=\"#cursorVisible-prop\">cursorVisible</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#customSoftwareInputPanel-prop\">customSoftwareInputPanel</a></b></b> : Component<tt> (preliminary)</tt></li>\n<li class=\"fn\"><b><b><a href=\"#displayText-prop\">displayText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#echoMode-prop\">echoMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#errorHighlight-prop\">errorHighlight</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#font-prop\">font</a></b></b> : font</li>\n<li class=\"fn\"><b><b><a href=\"#hasClearButton-prop\">hasClearButton</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#highlighted-prop\">highlighted</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#horizontalAlignment-prop\">horizontalAlignment</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#iconName-prop\">iconName</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#iconSource-prop\">iconSource</a></b></b> : url</li>\n<li class=\"fn\"><b><b><a href=\"#inputMask-prop\">inputMask</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodComposing-prop\">inputMethodComposing</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#inputMethodHints-prop\">inputMethodHints</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#length-prop\">length</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#maximumLength-prop\">maximumLength</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#mouseSelectionMode-prop\">mouseSelectionMode</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#passwordCharacter-prop\">passwordCharacter</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#persistentSelection-prop\">persistentSelection</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#placeholderText-prop\">placeholderText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#popover-prop\">popover</a></b></b> : var</li>\n<li class=\"fn\"><b><b><a href=\"#primaryItem-prop\">primaryItem</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#readOnly-prop\">readOnly</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#renderType-prop\">renderType</a></b></b> : enumeration</li>\n<li class=\"fn\"><b><b><a href=\"#secondaryItem-prop\">secondaryItem</a></b></b> : list&lt;Object&gt;</li>\n<li class=\"fn\"><b><b><a href=\"#selectByMouse-prop\">selectByMouse</a></b></b> : bool</li>\n<li class=\"fn\"><b><b><a href=\"#selectedText-prop\">selectedText</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#selectedTextColor-prop\">selectedTextColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionColor-prop\">selectionColor</a></b></b> : color</li>\n<li class=\"fn\"><b><b><a href=\"#selectionEnd-prop\">selectionEnd</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#selectionStart-prop\">selectionStart</a></b></b> : int</li>\n<li class=\"fn\"><b><b><a href=\"#style-prop\">style</a></b></b> : Component</li>\n<li class=\"fn\"><b><b><a href=\"#text-prop\">text</a></b></b> : string</li>\n<li class=\"fn\"><b><b><a href=\"#validator-prop\">validator</a></b></b> : Validator</li>\n<li class=\"fn\"><b><b><a href=\"#verticalAlignment-prop\">verticalAlignment</a></b></b> : enumeration</li>\n</ul>\n<a name=\"signals\"></a>\n<h2>Signals</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#accepted-signal\">accepted</a></b></b>()</li>\n</ul>\n<a name=\"methods\"></a>\n<h2>Methods</h2>\n<ul>\n<li class=\"fn\"><b><b><a href=\"#copy-method\">copy</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#cut-method\">cut</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#deselect-method\">deselect</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#getText-method\">getText</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#insert-method\">insert</a></b></b>(<i>position</i>, <i>text</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#isRightToLeft-method\">isRightToLeft</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#moveCursorSelection-method\">moveCursorSelection</a></b></b>(<i>position</i>, <i>mode</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#paste-method\">paste</a></b></b>(<i>data</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionAt-method\">positionAt</a></b></b>(<i>x</i>, <i>position</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#positionToRectangle-method\">positionToRectangle</a></b></b>(<i>pos</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#redo-method\">redo</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#remove-method\">remove</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#select-method\">select</a></b></b>(<i>start</i>, <i>end</i>)</li>\n<li class=\"fn\"><b><b><a href=\"#selectAll-method\">selectAll</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#selectWord-method\">selectWord</a></b></b>()</li>\n<li class=\"fn\"><b><b><a href=\"#undo-method\">undo</a></b></b>()</li>\n</ul>\n<!-- $$$TextField-description -->\n<a name=\"details\"></a>\n<h2>Detailed Description</h2>\n<p><b>This component is under heavy development.</b></p>\n<p><a href=\"http://design.ubuntu.com/apps/building-blocks/text-field\">See also the Design Guidelines on the Text Field</a>.</p>\n<p>Example:</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQuick.Item\">Item</a></span> {\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;hint text&quot;</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;without clear sign&quot;</span>\n <span class=\"name\">hasClearButton</span>: <span class=\"number\">false</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;password&quot;</span>\n <span class=\"name\">echoMode</span>: <span class=\"name\">TextInput</span>.<span class=\"name\">Password</span>\n }\n <span class=\"type\">TextField</span> {\n <span class=\"name\">placeholderText</span>: <span class=\"string\">&quot;overlaid in front&quot;</span>\n <span class=\"name\">primaryItem</span>: <span class=\"name\">Image</span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">source</span>: <span class=\"string\">&quot;magnifier.png&quot;</span>\n }\n <span class=\"name\">secondaryItem</span>: <span class=\"name\">Row</span> {\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;compose&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">doSomething</span>()\n }\n <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Button\">Button</a></span> {\n <span class=\"name\">height</span>: <span class=\"name\">parent</span>.<span class=\"name\">height</span>\n <span class=\"name\">width</span>: <span class=\"name\">height</span>\n <span class=\"name\">iconName</span>: <span class=\"string\">&quot;undo&quot;</span>\n <span class=\"name\">onClicked</span>: <span class=\"name\">doSomething</span>()\n }\n }\n }\n}</pre>\n<!-- @@@TextField -->\n<h2>Property Documentation</h2>\n<!-- $$$acceptableInput -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"acceptableInput-prop\"></a><span class=\"name\">acceptableInput</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property is always true unless a validator or input mask has been set. If a validator or input mask has been set, this property will only be true if the current text is acceptable to the validator or input mask as a final string (not as an intermediate string).</p>\n</div></div><!-- @@@acceptableInput -->\n<br/>\n<!-- $$$action -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"action-prop\"></a><span class=\"name\">action</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.Action\">Action</a> associated with this <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a>. If action is set, the values of the Action properties are copied to the values of the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem\">ActionItem</a> properties.</p>\n</div></div><!-- @@@action -->\n<br/>\n<!-- $$$activeFocusOnPress -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"activeFocusOnPress-prop\"></a><span class=\"name\">activeFocusOnPress</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the TextField should gain active focus on a mouse press. By default this is set to true.</p>\n</div></div><!-- @@@activeFocusOnPress -->\n<br/>\n<!-- $$$autoScroll -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"autoScroll-prop\"></a><span class=\"name\">autoScroll</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Whether the TextField should scroll when the text is longer than the width. By default this is set to true.</p>\n</div></div><!-- @@@autoScroll -->\n<br/>\n<!-- $$$canPaste -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canPaste-prop\"></a><span class=\"name\">canPaste</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextField is writable and the content of the clipboard is suitable for pasting into the TextField.</p>\n</div></div><!-- @@@canPaste -->\n<br/>\n<!-- $$$canRedo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canRedo-prop\"></a><span class=\"name\">canRedo</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextField is writable and there are undone operations that can be redone.</p>\n</div></div><!-- @@@canRedo -->\n<br/>\n<!-- $$$canUndo -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"canUndo-prop\"></a><span class=\"name\">canUndo</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns true if the TextField is writable and there are previous operations that can be undone.</p>\n</div></div><!-- @@@canUndo -->\n<br/>\n<!-- $$$color -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"color-prop\"></a><span class=\"name\">color</span> : <span class=\"type\"><a href=\"#color-prop\">color</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The text color.</p>\n</div></div><!-- @@@color -->\n<br/>\n<!-- $$$contentHeight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentHeight-prop\"></a><span class=\"name\">contentHeight</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the height of the text, including the height past the height that is covered if the text does not fit within the set height.</p>\n</div></div><!-- @@@contentHeight -->\n<br/>\n<!-- $$$contentWidth -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"contentWidth-prop\"></a><span class=\"name\">contentWidth</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-real.html\">real</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Returns the width of the text, including the width past the width which is covered due to insufficient wrapping if wrapMode is set.</p>\n</div></div><!-- @@@contentWidth -->\n<br/>\n<!-- $$$cursorDelegate -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorDelegate-prop\"></a><span class=\"name\">cursorDelegate</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The delegate for the cursor in the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a>.</p>\n<p>If you set a cursorDelegate for a <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a>, this delegate will be used for drawing the cursor instead of the standard cursor. An instance of the delegate will be created and managed by the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a> when a cursor is needed, and the x property of delegate instance will be set so as to be one pixel before the top left of the current character.</p>\n<p>Note that the root item of the delegate component must be a <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qquickitem.html\">QQuickItem</a> or <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/qquickitem.html\">QQuickItem</a> derived item.</p>\n</div></div><!-- @@@cursorDelegate -->\n<br/>\n<!-- $$$cursorPosition -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorPosition-prop\"></a><span class=\"name\">cursorPosition</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-int.html\">int</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The position of the cursor in the TextField.</p>\n</div></div><!-- @@@cursorPosition -->\n<br/>\n<!-- $$$cursorRectangle -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorRectangle-prop\"></a><span class=\"name\">cursorRectangle</span> : <span class=\"type\">rectangle</span></p></td></tr></table></div><div class=\"qmldoc\"><p>The rectangle where the standard text cursor is rendered within the text input. Read only.</p>\n<p>The position and height of a custom <a href=\"#cursorDelegate-prop\">cursorDelegate</a> are updated to follow the cursorRectangle automatically when it changes. The width of the delegate is unaffected by changes in the cursor rectangle.</p>\n</div></div><!-- @@@cursorRectangle -->\n<br/>\n<!-- $$$cursorVisible -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"cursorVisible-prop\"></a><span class=\"name\">cursorVisible</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Set to true when the TextField shows a cursor.</p>\n<p>This property is set and unset when the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a> gets active focus, so that other properties can be bound to whether the cursor is currently showing. As it gets set and unset automatically, when you set the value yourself you must keep in mind that your value may be overwritten.</p>\n<p>It can be set directly in script, for example if a KeyProxy might forward keys to it and you desire it to look active when this happens (but without actually giving it active focus).</p>\n<p>It should not be set directly on the item, like in the below QML, as the specified value will be overridden an lost on focus changes.</p>\n<pre class=\"qml\"><span class=\"type\"><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a></span> {\n <span class=\"name\">text</span>: <span class=\"string\">&quot;Text&quot;</span>\n <span class=\"name\">cursorVisible</span>: <span class=\"number\">false</span>\n}</pre>\n<p>In the above snippet the cursor will still become visible when the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a> gains active focus.</p>\n</div></div><!-- @@@cursorVisible -->\n<br/>\n<!-- $$$customSoftwareInputPanel -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"customSoftwareInputPanel-prop\"></a><span class=\"name\">customSoftwareInputPanel</span> : <span class=\"type\"><a href=\"/api/qml/sdk-14.04/QtQml.Component\">Component</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p><b>This documentation is under development and is subject to change.</b></p>\n<p>Component to be shown and used instead of the default On Screen Keyboard.</p>\n</div></div><!-- @@@customSoftwareInputPanel -->\n<br/>\n<!-- $$$displayText -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"displayText-prop\"></a><span class=\"name\">displayText</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This is the text displayed in the TextField.</p>\n<p>If <a href=\"#echoMode-prop\">echoMode</a> is set to TextInput::Normal, this holds the same value as the <a href=\"http://qt-project.org/doc/qt-5.0/qtquick-index.html/text.html\">text</a> property. Otherwise, this property holds the text visible to the user, while the text property holds the actual entered text.</p>\n</div></div><!-- @@@displayText -->\n<br/>\n<!-- $$$echoMode -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"echoMode-prop\"></a><span class=\"name\">echoMode</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies how the text should be displayed in the TextField.</p>\n<ul>\n<li>- <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.Normal - Displays the text as it is. (Default)</li>\n<li>- <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.Password - Displays asterixes instead of characters.</li>\n<li>- <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.NoEcho - Displays nothing.</li>\n<li>- <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.PasswordEchoOnEdit - Displays characters as they are entered while editing, otherwise displays asterisks.</li>\n</ul>\n</div></div><!-- @@@echoMode -->\n<br/>\n<!-- $$$effectiveHorizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"effectiveHorizontalAlignment-prop\"></a><span class=\"name\">effectiveHorizontalAlignment</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>See <a href=\"#horizontalAlignment-prop\">horizontalAlignment</a> for details.</p>\n</div></div><!-- @@@effectiveHorizontalAlignment -->\n<br/>\n<!-- $$$errorHighlight -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"errorHighlight-prop\"></a><span class=\"name\">errorHighlight</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Allows highlighting errors in the TextField.</p>\n</div></div><!-- @@@errorHighlight -->\n<br/>\n<!-- $$$font -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"font-prop\"></a><span class=\"name\">font</span> : <span class=\"type\"><a href=\"#font-prop\">font</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Font used in the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a>.</p>\n</div></div><!-- @@@font -->\n<br/>\n<!-- $$$hasClearButton -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"hasClearButton-prop\"></a><span class=\"name\">hasClearButton</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Specifies whether the control has a clear button or not.</p>\n</div></div><!-- @@@hasClearButton -->\n<br/>\n<!-- $$$highlighted -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"highlighted-prop\"></a><span class=\"name\">highlighted</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The property presents whether the TextField is highlighted or not. By default the TextField gets highlighted when gets the focus, so can accept text input. This property allows to control the highlight separately from the focused behavior.</p>\n</div></div><!-- @@@highlighted -->\n<br/>\n<!-- $$$horizontalAlignment -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"horizontalAlignment-prop\"></a><span class=\"name\">horizontalAlignment</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Sets the horizontal alignment of the text within the item's width and height. By default, the text alignment follows the natural alignment of the text, for example text that is read from left to right will be aligned to the left.</p>\n<p><a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a> does not have vertical alignment, as the natural height is exactly the height of the single line of text. If you set the height manually to something larger, <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> will always be top aligned vertically. You can use anchors to align it however you want within another item.</p>\n<p>The valid values for horizontalAlignment are <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignLeft, <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignRight and <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignHCenter.</p>\n<p>Valid values for <a href=\"#verticalAlignment-prop\">verticalAlignment</a> are <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignTop (default), <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignBottom <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a>.AlignVCenter.</p>\n<p>When using the attached property <a href=\"/api/qml/sdk-14.04/QtQuick.LayoutMirroring#enabled-prop\">LayoutMirroring::enabled</a> to mirror application layouts, the horizontal alignment of text will also be mirrored. However, the property horizontalAlignment will remain unchanged. To query the effective horizontal alignment of <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a>, use the read-only property <a href=\"#effectiveHorizontalAlignment-prop\">effectiveHorizontalAlignment</a>.</p>\n</div></div><!-- @@@horizontalAlignment -->\n<br/>\n<!-- $$$iconName -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconName-prop\"></a><span class=\"name\">iconName</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The icon associated with the actionItem in the ubuntu-mobile icon theme. Default value: action.iconName.</p>\n<p>If both <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconSource-prop\">iconSource</a> and iconName are defined, iconName will be ignored.</p>\n</div></div><!-- @@@iconName -->\n<br/>\n<!-- $$$iconSource -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"iconSource-prop\"></a><span class=\"name\">iconSource</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-url.html\">url</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>The image associated with the actionItem. Default value: action.iconSource.</p>\n<p>If both iconSource and <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> are defined, <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.ActionItem#iconName-prop\">iconName</a> will be ignored.</p>\n</div></div><!-- @@@iconSource -->\n<br/>\n<!-- $$$inputMask -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMask-prop\"></a><span class=\"name\">inputMask</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-string.html\">string</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Allows you to set an input mask on the TextField, restricting the text inputs. See QLineEdit::inputMask for further details, as the exact same mask strings are used by TextField.</p>\n</div></div><!-- @@@inputMask -->\n<br/>\n<!-- $$$inputMethodComposing -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodComposing-prop\"></a><span class=\"name\">inputMethodComposing</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-bool.html\">bool</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>This property holds whether the <a href=\"/api/qml/sdk-14.04/QtQuick.TextInput\">TextInput</a> has partial text input from an input method.</p>\n<p>While it is composing an input method may rely on mouse or key events from the <a href=\"/api/qml/sdk-14.04/Ubuntu.Components.TextField\">TextField</a> to edit or commit the partial text. This property can be used to determine when to disable events handlers that may interfere with the correct operation of an input method.</p>\n</div></div><!-- @@@inputMethodComposing -->\n<br/>\n<!-- $$$inputMethodHints -->\n<div class=\"qmlitem\"><div class=\"qmlproto\"><table class=\"qmlname\"><tr valign=\"top\" class=\"odd\"><td class=\"tblQmlPropNode\"><p><a name=\"inputMethodHints-prop\"></a><span class=\"name\">inputMethodHints</span> : <span class=\"type\"><a href=\"http://qt-project.org/doc/qt-5.0/qtqml/qml-enumeration.html\">enumeration</a></span></p></td></tr></table></div><div class=\"qmldoc\"><p>Provides hints to the input method about the expected content of the text input and how it should operate.</p>\n<p>The value is a bit-wise combination of flags, or Qt.ImhNone if no hints are set.</p>\n<p>Flags that alter behaviour are:</p>\n<ul>\n<li>- Qt.ImhHiddenText - Characters should be hidden, as is typically used when entering passwords. This is automatically set when setting <a href=\"#echoMode-prop\">echoMode</a> to <tt>TextInput.Password</tt>.</li>\n<li>- Qt.ImhSensitiveData - Typed text should not be stored by the active input method in any persistent storage like predictive user dictionary.</li>\n<li>- Qt.ImhNoAutoUppercase - The input method should not try to automatically switch to upper case when a sentence ends.</li>\n<li>- Qt.ImhPreferNumbers - Numbers are preferred (but not required).</li>\n<li>- Qt.ImhPreferUppercase - Upper case letters are preferred (but not required).</li>\n<li>- Qt.ImhPreferLowercase - Lower case letters are preferred (but not required).</li>\n<li>- Qt.ImhNoPredictiveText - Do not use predictive text (i.e&#x2e; dictionary lookup) while typing.</li>\n<li>- Qt.ImhDate - The text editor functions as a date field.</li>\n<li>- Qt.ImhTime - The text editor functions as a time field.</li>\n</ul>\n<p>Flags that restrict input (exclusive flags) are:</p>\n<ul>\n<li>- Qt.ImhDigitsOnly - Only digits are allowed.</li>\n<li>- Qt.ImhFormattedNumbersOnly - Only number input is allowed. This includes decimal point and minus sign.</li>\n<li>- Qt.ImhUppercaseOnly - Only upper case letter input is allowed.</li>\n<li>- Qt.ImhLowercaseOnly - Only lower case letter input is allowed.</li>\n<li>- Qt.ImhDialableCharactersOnly - Only characters suitable for phone dialing are allowed.</li>\n<li>- Qt.ImhEmailCharactersOnly - Only characters suitable for email addresses are allowed.</li>\n<li>- Qt.ImhUrlCharactersOnly - Only characters suitable for URLs are allowed.</li>\n</ul>\n<p>M