Qt wiki will be updated on October 12th 2023 starting at 11:30 AM (EEST) and the maintenance will last around 2-3 hours. During the maintenance the site will be unavailable.
SailfishOS using app in emulator basics
[toc align_right="yes" depth="2"]
English | Polski
'_ Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial. "< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough '_
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.
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 img 2
Pull the pulley menu all the way down to expose the entire menu, and tap on the menu item to activate img 3
In the second Page, notice the visual indicators at the top left corner. They indicate the level of the stacked Page.
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. img 5
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 close app a
2. In the application screen push the application from top close app a
3. You can also close the application directly from QtCreator by using the stop button
'_ Article is part 3 of "Introduction Tutorial":/wiki/Category:SailfishOS::Introduction_tutorial. "< Go To Part 2":/wiki/SailfishOS_first_application ||| "Go To Part 4 >":/wiki/SailfishOS_code_walkthrough '_