View source for SailfishOS using app in emulator basics

{{Cleanup | reason=Auto-imported from ExpressionEngine.}}

[[Category:SailfishOS::Introduction_tutorial]]


'''English''' | [[:SailfishOS_using_app_in_emulator_basics_Polish|Polski]]


----

Article is part 3 of [https://wiki.qt.io/Category:SailfishOS::Introduction_tutorial Introduction tutorial] <br>
< [https://wiki.qt.io/SailfishOS_first_application Go to part 2] ||| [https://wiki.qt.io/SailfishOS_code_walkthrough Go To Part 4] >

----


= Using SailfishOS Apps =

SailfishOS is a touch based UI and here is a quick explaination how to use some of the gestures in the emulator - for a complete explanation see the UX framework page.

There are two kinds of gestures in SailfishOS - "pulls" are those within the screen; "pushes" are those starting outside the screen. It may help to think of moving an edge of the screen by pushing or pulling it.

''Hint: Pushes are a little tricky to use in the emulator with a mouse since they actually start at the very edge of the window - some users prefer to disable mouse integration in VirtualBox (press Host + "I" or use the Machine menu) to make it easier to push from the edge.''

== Pulley Menu ==

In the UI, notice the glow at the top edge. It indicates a pulley menu which can be revealed with a pull-down gesture in the main window.

http://i.imgur.com/4QkhXOb.png

== Nested Page ==

The pulley menu item "Show Page 2" takes you to the next Page. The menu item can be activated in two ways:

Pull the pulley menu down until the menu item is highlighted; then release to activate, or

http://i.imgur.com/KB3B8uu.png

Pull the pulley menu all the way down to expose the entire menu, and tap on the menu item to activate

http://i.imgur.com/IZzK83v.png

In the second Page, notice the visual indicators at the top left corner. They indicate the level of the stacked Page.

http://i.imgur.com/CtyREsi.png

To move back to the first page you can:
* simply pull from left to right anywhere in the screen
* pull from left to right on the page header(useful if the screen has other touch functionality)
* touch the glowing page indicator in the top left corner

== Active Cover ==

Applications running in the background have "Covers" which provide a visual summary for the application and support interactiion as well. They are displayed in the Home area.

You can access the Home area and see the active cover of the application you just compiled by pushing the application from the side.

http://i.imgur.com/h5vF6rd.png

This application is showing "My Cover" as the visual representation and provides Play and Pause icons to describe the possible actions.

Pull the cover from left to right to access the left action; pull the other way for the right action.

== Stopping the application ==

There are at least few ways to close the app, most typical are:

1. In the Home screen press and hold the application until the covers fade out and provide a close button - then tap the close button

http://i.imgur.com/REG10Vp.png

2. In the application screen push the application from top

http://i.imgur.com/00rAHJX.png

3. You can also close the application directly from QtCreator by using the stop button



----

Article is part 3 of [https://wiki.qt.io/Category:SailfishOS::Introduction_tutorial Introduction tutorial] <br>
< [https://wiki.qt.io/SailfishOS_first_application Go to part 2] ||| [https://wiki.qt.io/SailfishOS_code_walkthrough Go To Part 4] >

----