The multiple window manager.
In Pebble OS, the window stack serves as the global manager of what window is presented, ensuring that input events are forwarded to the topmost window. The navigation model of Pebble centers on the concept of a vertical “stack” of windows, similar to mobile app interactions.
In working with the Window Stack API, the basic operations include push and pop. When an app wants to display a new window, it pushes a new window onto the stack. This appears like a window sliding in from the right. As an app is closed, the window is popped off the stack and disappears.
For more complicated operations, involving multiple windows, you can determine which windows reside on the stack, using window_stack_contains_window() and remove any specific window, using window_stack_remove().
Refer to the User Interface Layers chapter in the Pebble Developer Guides (chapter "Window Stack") for a conceptual overview of the window stack and relevant code examples.
Also see the WindowHandlers of a Window for the callbacks that can be added to a window in order to act upon window stack transitions.
Pushes the given window on the window navigation stack, on top of the current topmost window of the app.
The window to push on top
Pass in true
to animate the push using a sliding animation, or false
to skip the animation.
Pops the topmost window on the navigation stack.
The window that is popped, or NULL if there are no windows to pop.
Pops all windows. See window_stack_remove() for a description of the animated
parameter and notes.
Removes a given window from the window stack that belongs to the app task.
If there are no windows for the app left on the stack, the app will be killed by the system, shortly. To avoid this, make sure to push another window shortly after or before removing the last window.
The window to remove. If the window is NULL or if it is not on the stack, this function is a no-op.
Pass in true
to animate the removal of the window using a side-to-side sliding animation to reveal the next window. This is only used in case the window happens to be on top of the window stack (thus visible).
True if window was successfully removed, false otherwise.
Gets the topmost window on the stack that belongs to the app.
The topmost window on the stack that belongs to the app or NULL if no app window could be found.
Checks if the window is on the window stack.
The window to look for on the window stack
true if the window is currently on the window stack.
Do you have questions about the Pebble SDK?
Do you need some help understanding something on this page?
You can either take advantage of our awesome developer community and check out the SDK Help forums, or you can send us a message through the website!