You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by an...@apache.org on 2016/07/11 13:47:04 UTC
docs commit: CB-11522 Do not clone the detail object on activation
context
Repository: cordova-docs
Updated Branches:
refs/heads/master 168329095 -> c2c59e880
CB-11522 Do not clone the detail object on activation context
Documents Windows activated event and its quirks
This closes #618
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/c2c59e88
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/c2c59e88
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/c2c59e88
Branch: refs/heads/master
Commit: c2c59e88085b42c5adbc7a189516a67dedd3ab78
Parents: 1683290
Author: daserge <v-...@microsoft.com>
Authored: Wed Jul 6 19:57:22 2016 +0300
Committer: Vladimir Kotikov <ko...@gmail.com>
Committed: Mon Jul 11 16:46:53 2016 +0300
----------------------------------------------------------------------
www/docs/en/dev/cordova/events/events.md | 39 +++++++++++++++++++++++++++
1 file changed, 39 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/c2c59e88/www/docs/en/dev/cordova/events/events.md
----------------------------------------------------------------------
diff --git a/www/docs/en/dev/cordova/events/events.md b/www/docs/en/dev/cordova/events/events.md
index 0e988bf..586e223 100644
--- a/www/docs/en/dev/cordova/events/events.md
+++ b/www/docs/en/dev/cordova/events/events.md
@@ -185,6 +185,15 @@ The following table lists the cordova events and the supported platforms:
<td data-col="winphone8" class="n"></td>
<td data-col="win" class="n"></td>
</tr>
+
+ <tr>
+ <th><a href="#activated">activated</a></th>
+ <td data-col="android" class="n"></td>
+ <td data-col="blackberry10" class="n"></td>
+ <td data-col="ios" class="n"></td>
+ <td data-col="winphone8" class="n"></td>
+ <td data-col="win" class="y"></td>
+ </tr>
</tbody>
</table>
@@ -433,5 +442,35 @@ function onVolumeUpKeyDown() {
}
```
+## activated
+
+The event fires when Windows Runtime activation has occurred. See [MSDN docs][MSDNActivatedEvent] for further details and activation types.
+
+### Quick Example
+
+```javascript
+document.addEventListener("activated", activated, false);
+
+function activated(args) {
+ if (args && args.kind === Windows.ApplicationModel.Activation.ActivationKind.file) {
+ // Using args.raw to get the native StorageFile object
+ Windows.Storage.FileIO.readTextAsync(args.raw.detail[0].files[0]).done(function (text) {
+ console.log(text);
+ }, function (err) {
+ console.error(err);
+ });
+ }
+}
+```
+
+### Windows Quirks
+
+* Original activated event args are available in `args.raw.detail[0]` property and can be used to get a type information or invoke methods of one of the activation arguments,
+
+* Original activated event args are also cloned to `args.detail[0]` and can be used as a fallback in case an inner args property has been lost.
+See https://issues.apache.org/jira/browse/CB-10653 for details.
+
+
[UIApplicationExitsOnSuspend]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
[AndroidLifeCycleGuide]: ../../guide/platforms/android/lifecycle.html
+[MSDNActivatedEvent]: https://msdn.microsoft.com/en-us/library/windows/apps/br212679.aspx
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org