meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
section:section-windows_dialog [2026/08/02 17:48] – dorepssection:section-windows_dialog [2026/08/03 12:15] (current) – doreps
Line 1: Line 1:
-====== Window - Options Dialog ====== +====== Understanding and Using Windows ====== - A comprehensive guide to the window layout element
-<WRAP hscroll_box> +
-<WRAP> +
-This topic covers the customization settings available for windows and folders to alter their behavior, appearance, and automation.+
  
-The Window Options menu provides extensive control over pop-up windows and folders within the launcher environment. Configuring these settings allows for a highly tailored user interface, improving device navigation, aesthetic cohesion, and functional automation.</WRAP> +This section explains the concept of windows within Total Launcher, detailing creation methods, property configuration, and practical applications for customized screen layouts.
-<WRAP> +
-{{:howto:howto-window-calendar-image-v4.webp?direct&200}} +
-</WRAP> +
- +
-===== Accessing Window Settings ===== +
-To configure a window or folder, follow the standard editing procedure: +
-   - Enter edit mode on the launcher home screen. +
-   - Select the target window or folder element. +
-     - Select the gear icon {{:ui:ui-icon_option-v4.webp?direct&25}} (lower right corner) to open the configuration menu. +
-     - Navigate to the ''OPTIONS'' tab at the bottom of the screen. +
- +
-===== Display and Layout Settings ===== +
-These options dictate the physical appearance and screen positioning of the window. +
-   * **Open alone:** - Closes all currently active windows and folders before opening the selected one. Maintains a clutter-free workspace and focuses the display on a single interface. +
- +
-   * **From bottom:** - Sets the window position to originate from the bottom of the screen. Facilitates the creation of modern bottom-sheet menus that are easily reachable for one-handed operation. +
- +
-   * **Full height:** - Expands the window to occupy the entire vertical space of the screen. Utilized for creating comprehensive app drawers or immersive custom dashboards. +
- +
-   * **Background:** - Defines the background color, Dynamic color, Icon pack, Shape, Image, or Dynamic image for the window. Here, color is represented by the hex value ''#FFFFD700''. Used to match the overall theme design of the launcher layout. +
- +
-   * **Fit background to window:** - Adjusts the assigned background image or color to fit exactly within the window boundaries, preventing visual overflow. +
- +
-   * **Show shadow:** - Applies a drop shadow effect around the exterior of the window. This adds visual depth and separates the active window from the underlying graphical elements. +
- +
-   * **Erase behind:** - Erases objects located behind the window or sliding drawer to reveal the system wallpaper through transparent areas. Allows for complex layering effects or custom mask cutouts. +
- +
-===== Interaction and Gestures ===== +
-These settings modify how the window responds to touch inputs and system navigation commands. +
-   * **Gesture to close:** - Configures a specific touch gesture, such as ''Swipe up'', to close the window. Provides fast, fluid navigation without requiring precise taps on a dedicated close button. Note that this requires a ''PRO'' license. +
- +
-   * **Ignore Back:** - Prevents the window from being closed using the system Back button or system navigation gesture. Utilized for creating persistent on-screen displays, mandatory menus, or kiosk-style locked interfaces. +
- +
-===== Automation and Actions ===== +
-Automated actions can be triggered based on the window's lifecycle state. +
-   * **Action on open:** - Selects an action to invoke automatically when the window opens. Utilized for launching supplementary applications, changing system settings, or triggering shortcut tasks simultaneously with the window launch. +
- +
-   * **Delay of action on open:** - Configures a specific delay, represented in milliseconds such as ''0ms'', before the open action triggers. Allows for sequencing entrance animations before a secondary action occurs. +
- +
-   * **Action on close:** - Selects an action to invoke automatically when the window is closed. Performs cleanup tasks or returns system settings to a previous state upon window dismissal. +
- +
-   * **Delay of action on close:** - Configures a delay, represented in milliseconds such as ''0ms'', before the close action triggers.  +
- +
-===== Configuration Tabs ===== +
-The bottom navigation bar allows switching between different configuration categories. +
-   * **OPTIONS:** - Displays the main configuration settings menu for layout, behavior, and actions as detailed in this document. +
- +
-   * **ANIMATION:** - Accesses a separate menu to configure transition styles, speeds, and entrance or exit animations for the window. +
- +
----- +
-====== Understanding and Using Windows ====== - A comprehensive guide to the window layout element +
-  * This section explains the concept of windows within Total Launcher, detailing creation methods, property configuration, and practical applications for customized screen layouts.+
  
 ===== What is a Window? ===== ===== What is a Window? =====
Line 71: Line 16:
   * **Non-modal:** - Permits active interaction with the background page while the window remains visible on screen.   * **Non-modal:** - Permits active interaction with the background page while the window remains visible on screen.
  
-==== Window Options Configuration ==== +===== Accessing Window Settings ===== 
-The Options dialog provides the following structural settings: +To configure a window or folder, follow the standard editing procedure: 
-  * **Open alone:** - Closes all currently open windows and folders before displaying the selected window. +  - Enter edit mode on the launcher home screen. 
-  * **From bottom:** - Anchors the window's vertical position relative to the bottom edge of the screen. +  - Select the target window or folder element. 
-  * **Full height:** - Expands the window to fill the maximum vertical space. If ''From bottom'' is also enabled, it stretches the window to touch the top of the screen. +    - Select the gear icon ''{{:ui:ui-icon_option-v4.webp?direct&25}}'' (lower right corner) to open the configuration menu. 
-  * **Background:** - Applies a solid color code (e.g., ''#FFCCCCCC''), an image, or transparency to the window container. +    - Navigate to the ''OPTIONS'' or ''ANIMATION'' tabs at the bottom of the screen to modify specific behaviors. 
-  * **Fit background to window:** - Stretches the background image to match the window container size, ignoring the original aspect ratio. When disabled, the image is cropped to fit while maintaining its proportions. + 
-  * **Show shadow:** - Generates a drop shadow effect around the exterior edges of the window. +===== Window Options Configuration ===== 
-  * **Erase behind:** - Masks objects located behind the window, revealing the device wallpaper through any transparent areas of the window layout. +<WRAP hscroll_box> 
-  * **Gesture to close:** - Assigns a specific directional swipe to dismiss the window (requires the PRO version). +<WRAP> 
-  * **Ignore Back:** - Prevents the device's system Back button or gesture from closing the window. +This topic covers the customization settings available for windows and folders to alter their behavior, appearance, and automation. The Window Options menu provides extensive control over pop-up windows within the launcher environment. Configuring these settings allows for a highly tailored user interface, improving device navigation, aesthetic cohesion, and functional automation. 
-  * **Action on open:** - Triggers a specific launcher action or shortcut immediately when the window opens. +</WRAP> 
-  * **Delay of action on open:** - Applies a specified delay (e.g., ''0ms'') before the open action executes. +<WRAP> 
-  * **Action on close:** - Triggers a specific launcher action when the window is dismissed. +{{:howto:howto-window-calendar-image-v4.webp?direct&200}} 
-  * **Delay of action on close:** - Applies a specified delay before the close action executes.+</WRAP> 
 +</WRAP> 
 +<WRAP clear /> 
 + 
 +==== Display and Layout Settings ==== 
 +These options dictate the physical appearance and screen positioning of the window. 
 +  * **Open alone:** - Closes all currently active windows and folders before opening the selected one. Maintains a clutter-free workspace and focuses the display on a single interface. 
 +  * **From bottom:** - Sets the window position to originate from the bottom of the screen. Facilitates the creation of modern bottom-sheet menus that are easily reachable for one-handed operation. 
 +  * **Full height:** - Expands the window to occupy the entire vertical space of the screen. Utilized for creating comprehensive app drawers or immersive custom dashboards. If ''From bottom'' is also enabled, it stretches the window to touch the top of the screen. 
 +  * **Background:** - Defines the background color, Dynamic color, Icon pack, Shape, Image, or Dynamic image for the window container. Here, color is represented by a hex value (e.g., ''#FFCCCCCC''). Used to match the overall theme design of the launcher layout. 
 +  * **Fit background to window:** - Adjusts the assigned background image or color to fit exactly within the window boundaries, preventing visual overflow. When disabled, the image is cropped to fit while maintaining its original proportions. 
 +  * **Show shadow:** - Applies a drop shadow effect around the exterior of the window. This adds visual depth and separates the active window from the underlying graphical elements. 
 +  * **Erase behind:** - Erases objects located behind the window or sliding drawer to reveal the system wallpaper through transparent areas. Allows for complex layering effects or custom mask cutouts. 
 + 
 +==== Interaction and Gestures ==== 
 +These settings modify how the window responds to touch inputs and system navigation commands. 
 +  * **Gesture to close:** - Configures a specific touch gesture, such as ''Swipe up'', to close the window. Provides fast, fluid navigation without requiring precise taps on a dedicated close button. Note that this requires a ''PRO'' license. 
 +  * **Ignore Back:** - Prevents the window from being closed using the system Back button or system navigation gesture. Used to create persistent on-screen displays, mandatory menus, or kiosk-style locked interfaces. 
 + 
 +==== Automation and Actions ==== 
 +Automated actions can be triggered based on the window's lifecycle state. 
 +  * **Action on open:** - Selects an action to invoke automatically when the window opens. Used to launch supplementary applications, change system settings, or trigger shortcut tasks simultaneously with the window launch. 
 +  * **Delay of action on open:** - Configures a specific delay, represented in milliseconds such as ''0ms'', before the open action triggers. Allows for sequencing entrance animations before a secondary action occurs. 
 +  * **Action on close:** - Selects an action to invoke automatically when the window is closed. Performs cleanup tasks or returns system settings to a previous state upon window dismissal. 
 +  * **Delay of action on close:** - Configures a delay, represented in milliseconds such as ''0ms'', before the close action triggers.
  
 ===== Creating and Designing a Window ===== ===== Creating and Designing a Window =====
Line 97: Line 66:
  
 ===== Triggers and Animations ===== ===== Triggers and Animations =====
-A window can be activated from any location on the screen using a shortcut or a gesture. Total Launcher also supports opening windows via shortcuts triggered by third-party applications. +A window can be activated from any location on the screen using a shortcut or a gesture. Total Launcher also supports opening windows via shortcuts triggered by third-party applications.
  
 ==== Opening and Closing Methods ==== ==== Opening and Closing Methods ====
Line 104: Line 73:
  
 ==== Window Animation Configuration ==== ==== Window Animation Configuration ====
 +<WRAP hscroll_box>
 +<WRAP>
 The Animation dialog controls the visual transition when a window appears or disappears: The Animation dialog controls the visual transition when a window appears or disappears:
   * **Enter animation:** - Defines the entrance style (e.g., ''From front'').   * **Enter animation:** - Defines the entrance style (e.g., ''From front'').
Line 113: Line 84:
   * **Animation duration (ms):** - Dictates the speed of the exit transition.   * **Animation duration (ms):** - Dictates the speed of the exit transition.
   * **Exiting sound:** - Triggers an audio file upon closing.   * **Exiting sound:** - Triggers an audio file upon closing.
 +</WRAP> 
 +<WRAP> 
 +{{:section:section-window-animation-dialog-v4.webp?direct&200|Window Animation dialog}} 
 +</WRAP> 
 +</WRAP>
 ===== Practical Use Cases ===== ===== Practical Use Cases =====
 Windows enable complex organizational structures without cluttering the main page: Windows enable complex organizational structures without cluttering the main page: