<h3 id="instances" name="instances">Retrieving Widget Instances</h3>
<p>Learning how to retrieve information about installed widget instances makes the Widget Service API more useful:</p>
+
+<div class="note">
+ <strong>Note</strong>
+ The <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/widgetservice.html#WidgetInstance::id">WidgetInstance.id</a> value is volatile and can change after device reboot.
+</div>
+
<ol>
<li><p>Define a success handler implementing the <code>WidgetInstancesCallback</code> interface (in <a href="../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/widgetservice.html#WidgetInstancesCallback">mobile</a> and <a href="../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/widgetservice.html#WidgetInstancesCallback">wearable</a> applications). Optionally, you can specify an error handler too.</p>
<pre class="prettyprint">
<li>Send or get content to and from the widget instance.</li>
</ul>
+<div class="note">
+ <strong>Note</strong>
+ These features are not supported by Web widgets. You can only use them in Web applications to manage installed widgets. For more information, see <a href="
+https://developer.tizen.org/dev-guide/2.3.2/org.tizen.web.apireference/html/widget_spec/web_widget.html#user-content-web-device-api">Web Device API supported by Widget Engine</a>.
+</div>
+
<h3 id="period" name="period">Changing the Update Period</h3>
<p>To change the update interval for the widget instance:</p>
<div class="typedef" id="WidgetInstanceId">
<a class="backward-compatibility-anchor" name="::WidgetService::WidgetInstanceId"></a><h3>1.2. WidgetInstanceId</h3>
<div class="brief">
- The unique ID of the installed widget instance.
+ ID of the widget instance, this value is volatile and may change after reboot.
</div>
<pre class="webidl prettyprint"> typedef DOMString WidgetInstanceId;</pre>
<p><span class="version">
Since: </span>
3.0
</p>
+<p><span class="remark"> Remark : </span>
+ This method can only be used with widgets and applications which belong to the same package. Therefore, the widget should belong to the package of the Web application which calls this method.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
Since: </span>
3.0
</p>
+<p><span class="remark"> Remark : </span>
+ This method can only be used with widgets and applications which belong to the same package. Therefore, the widget should belong to the package of the Web application which calls this method.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
<li class="attribute" id="WidgetInstance::id">
<span class="attrName"><span class="readonly"> readonly
</span><span class="type">WidgetInstanceId </span><span class="name">id</span></span><div class="brief">
- The unique ID of the widget instance.
+ ID of the widget instance, this value is volatile and may change after reboot.
</div>
<p><span class="version">
Since: </span>
Since: </span>
3.0
</p>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
This function does not wait for a confirmation that the data was updated.
</p>
</div>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
AbortError - If the operation cannot be finished properly. </li>
</ul>
</div>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
<div class="typedef" id="WidgetInstanceId">
<a class="backward-compatibility-anchor" name="::WidgetService::WidgetInstanceId"></a><h3>1.2. WidgetInstanceId</h3>
<div class="brief">
- The unique ID of the installed widget instance.
+ ID of the widget instance, this value is volatile and may change after reboot.
</div>
<pre class="webidl prettyprint"> typedef DOMString WidgetInstanceId;</pre>
<p><span class="version">
readonly attribute boolean noDisplay;
DOMString getName(optional DOMString? locale) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
+
void getInstances(<a href="#WidgetInstancesCallback">WidgetInstancesCallback</a> successCallback, optional <a href="tizen.html#ErrorCallback">ErrorCallback</a>? errorCallback) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
<a href="#WidgetVariant">WidgetVariant</a> getVariant(<a href="#WidgetSizeType">WidgetSizeType</a> sizeType) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
<li class="attribute" id="WidgetInstance::id">
<span class="attrName"><span class="readonly"> readonly
</span><span class="type">WidgetInstanceId </span><span class="name">id</span></span><div class="brief">
- The unique ID of the widget instance.
+ ID of the widget instance, this value is volatile and may change after reboot.
</div>
<p><span class="version">
Since: </span>
Since: </span>
2.3.2
</p>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
This function does not wait for a confirmation that the data was updated.
</p>
</div>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
AbortError - If the operation cannot be finished properly. </li>
</ul>
</div>
+<p><span class="remark"> Remark : </span>
+ This method is not supported by Web Widget.
+ </p>
<div class="parameters">
<p><span class="param">Parameters:</span></p>
<ul>
readonly attribute boolean noDisplay;
DOMString getName(optional DOMString? locale) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
+
void getInstances(<a href="#WidgetInstancesCallback">WidgetInstancesCallback</a> successCallback, optional <a href="tizen.html#ErrorCallback">ErrorCallback</a>? errorCallback) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);
<a href="#WidgetVariant">WidgetVariant</a> getVariant(<a href="#WidgetSizeType">WidgetSizeType</a> sizeType) raises(<a href="tizen.html#WebAPIException">WebAPIException</a>);