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
howto:howto-window-create_simple [2026/07/16 16:10] dorepshowto:howto-window-create_simple [2026/07/19 12:00] (current) – ↷ Links adapted because of a move operation doreps
Line 1: Line 1:
-<WRAP hide>%%<!-- googleoff: index -->%%</WRAP> +====== Mastering Android Theming: A Total Launcher Window and Widget Configuration Tutorial ======
-<WRAP center notice centeralign> +
-**⚠️ v4.0 UI Transition Notice - In Process:** +
-//The release of Total Launcher v4.0 has introduced significant user interface changes. Please note that this  +
-page does not yet reflect these updates. The new layout paths, folds, and visual maps are currently being  +
-compiled and will be deployed shortly.// +
-</WRAP> +
-<WRAP hide>%%<!-- googleon: index -->%%</WRAP> +
- +
- +
- +
----- +
- +
- +
-===== Window: Create (simple) + Add a Widget ===== +
  
-=== Window: Create (simple) ===+Mastering Android interface customization requires precise control over container elements and layout properties. This tutorial outlines the exact procedure for creating a functional window container that hosts application widgets within the Total Launcher ecosystem. By establishing a solid visual foundation, designers and enthusiasts can avoid common configuration pitfalls, such as unintentionally deploying transparent, unselectable screens on the display. Implementing these structured techniques ensures a stable dashboard framework before initiating window creation.
  
 <WRAP GROUP> <WRAP GROUP>
 <WRAP center round tip 60%> <WRAP center round tip 60%>
 <WRAP centeralign> <WRAP centeralign>
-**From experience, a window can be created and the user can not see it!**+**From experience, a window can be createdand the user can not see it!**
 </WRAP> </WRAP>
 This happens if 2 options and 1 action are set: This happens if 2 options and 1 action are set:
Line 32: Line 18:
 </WRAP> </WRAP>
  
-Since the above TIP has been mentioned, the procedure includes the "simple" addition of adding an "App widget". If that is not what is wanted, simply change what the window is to contain ... leave the window empty but make sure to retain the default ''background'' so the window does not appear to "disappear".+Since the above TIP has been mentioned, the procedure includes the "simple" addition of adding an "App widget". If that is not what is wanted, simply change what the window contains... leave the window emptybut make sure to retain the default ''background'' so the window does not appear to "disappear".
  
-  - On the home screen, enter Edit On mode (see[[section:section1-2-e_beginners_basic_editing_steps#edit-on| here]] for details), or one method is to long-press an empty space. +===== Window: Create (simple) ===== 
-  In the to Object Design Menu tap the {{ui:ui-icon_add_gray-v4.webp?25}} icon + 
-  Select Graphic +== Step 1 == 
-  Select either •Image or •Text+  * On the home screen, enter Edit On mode (see[[section:section-basic_editing#edit-on| here]] for details), or one method is to long-press an empty space. 
 +== Step 2 == 
 +  In the to Object Design Menu tap the {{ui:ui-icon_add_gray-v4.webp?25}} icon 
 +== Step 3 == 
 +  Select Graphic 
 +== Step 4 == 
 +  Select either •Image or •Text
     - Image if the screen object to open the window will be an icon-type     - Image if the screen object to open the window will be an icon-type
     - Text if the screen object to open the window will be text-based     - Text if the screen object to open the window will be text-based
       * Note: There is another way to open a window: [[:section:section-gestures|gestures]].        * Note: There is another way to open a window: [[:section:section-gestures|gestures]]. 
     - ''Image'' will be the example selected here     - ''Image'' will be the example selected here
-  - From the dialog listing, select ''Window''+== Step 5 == 
 +  * From the dialog listing, select ''Window''
     - The Window-Portrait dialog shows any previously created windows ++(see image). | {{:ui:ui-window-portrait_dialog-v4.webp?direct&200}}++     - The Window-Portrait dialog shows any previously created windows ++(see image). | {{:ui:ui-window-portrait_dialog-v4.webp?direct&200}}++
       * When a window design is created, it is specific to its designed purpose and will retain its previous characteristics or, if modified here, will change those characteristics where it is elsewhere being used.       * When a window design is created, it is specific to its designed purpose and will retain its previous characteristics or, if modified here, will change those characteristics where it is elsewhere being used.
Line 49: Line 42:
         * Note: no spaces or hyphens are permitted, only underscores (_)         * Note: no spaces or hyphens are permitted, only underscores (_)
     - Tap OK     - Tap OK
-  - Tap the Action icon {{ui:ui-icon_action-v4.webp?15}} to open the new window in full screen mode ++(see image). | {{:howto:howto-window_create-edit_1.webp?direct&200}}++ By default, the window background is light gray. The top Object Design Menu {{:howto:howto-window_create-edit_menu.webp?200}} includes 2 key icons:+== Step 6 == 
 +  * Tap the Action icon {{ui:ui-icon_action-v4.webp?15}} to open the new window in full screen mode ++(see image). | {{ui:ui-window-page_design-dialog-v4.webp?direct&200}}++ By default, the window background is light gray. The top Object Design Menu {{ui:ui-window-page_design-menu-v4.webp?200}} includes 2 key icons:
     - Edit (pencil) {{ui:ui-icon_edit-v4.webp?15}} - Tap this to enable:     - Edit (pencil) {{ui:ui-icon_edit-v4.webp?15}} - Tap this to enable:
       * bulb handles on its boundaries used to downsize the window       * bulb handles on its boundaries used to downsize the window
-      *Option icon {{ui:ui-icon_option-v4.webp?15}} in the lower right corner of the window opens the Window Option dialog and the Window Animation dialog. ++(see image). | {{:howto:howto-window_create-edit_2.webp?direct&200}}+++      *Option icon {{ui:ui-icon_option-v4.webp?15}} in the lower right corner of the window opens the Window Option dialog and the Window Animation dialog. ++(see image). | {{ui:ui-window-option-v4.webp?direct&200}}++
         * While the Edit and Option dialogs will not be discussed here, more information is available at [[admin:drafts:section-window-option_dialog|Window - Option]] and [[admin:drafts:section-window-animation_dialog|Window - Animation]] in the uiTotalLauncherManual wiki.         * While the Edit and Option dialogs will not be discussed here, more information is available at [[admin:drafts:section-window-option_dialog|Window - Option]] and [[admin:drafts:section-window-animation_dialog|Window - Animation]] in the uiTotalLauncherManual wiki.
     - Add icon {{ui:ui-icon_add_gray-v4.webp?15}} - opens the Add Object dialog     - Add icon {{ui:ui-icon_add_gray-v4.webp?15}} - opens the Add Object dialog
       * Objects, such as an app widget, layout, or graphic, can be added to a new window.        * Objects, such as an app widget, layout, or graphic, can be added to a new window. 
         * In this example, only the window is being created, so an object will //not// be added.          * In this example, only the window is being created, so an object will //not// be added. 
-              * If an object is to be added now, see these steps, which will replace Steps 6.and 6.d, and the procedure Window: Add an Existing Widget to a Window after the Window Has Been Created. [[:howto:howto-window-create_simple-insert-add_window_now|Click here.]] +              * If an object is to be added now, see these steps, which will replace Steps 6.and 6.4, and the procedure Window: Add an Existing Widget to a Window after the Window Has Been Created. [[:howto:howto-window-create_simple-insert-add_window_now|Click here.]] 
     - Back out of the window by swiping right-to-left to return to the Window-Portrait dialog     - Back out of the window by swiping right-to-left to return to the Window-Portrait dialog
     - Back out of the dialog by swiping right-to-left again     - Back out of the dialog by swiping right-to-left again
 == Step 7 == == Step 7 ==
-  - The new "image" for the window object icon (not the window itself) appears in the center of the page selected (highlighted) ++(see image). | {{:howto:howto-window_create-window_object-selected.webp?direct&200}}+++  - The new "image" for the window object icon (not the window itself) appears in the center of the page selected (highlighted) ++(see image). | {{ui:ui-window-placeholder-selected-v4.webp?direct&200}}++
       * The "bulbs" in the center of each container border can be used as a handle to tap-hold and drag to modify the area of the window object icon.       * The "bulbs" in the center of each container border can be used as a handle to tap-hold and drag to modify the area of the window object icon.
         * Resize and position on the screen as desired         * Resize and position on the screen as desired
Line 67: Line 61:
   - The window object icon, which activates the window, is on the page with its default image.   - The window object icon, which activates the window, is on the page with its default image.
     - This image can be changed by selecting the object (tap and hold to highlight), which opens the top Object Design Menu.     - This image can be changed by selecting the object (tap and hold to highlight), which opens the top Object Design Menu.
-    - The top Object Design Menu Option icon {{ui:ui-icon_option-v4.webp?15}} opens the Option Edit dialog ++(see image). | {{:howto:howto-window_create-window_object-option.webp?direct&200}}+++    - The top Object Design Menu Option icon {{ui:ui-icon_option-v4.webp?15}} opens the Option Edit dialog ++(see image). | {{ui:ui-window-placeholder-edit-option-v4.webp?direct&200}}++
       * Tap the Image field to open the Image selection categories.       * Tap the Image field to open the Image selection categories.
         * Experiment with the Image and Icon Pack categories.         * Experiment with the Image and Icon Pack categories.
Line 74: Line 68:
     - The window object icon must be selected, then ...     - The window object icon must be selected, then ...
       * Tap the top Object Design Menu Action icon {{ui:ui-icon_action-v4.webp?15}}       * Tap the top Object Design Menu Action icon {{ui:ui-icon_action-v4.webp?15}}
-    - The Action dialog opens ++(see image). | {{:howto:howto-window-create-object-tap_action-dialog.webp?direct&200}}++ +    - The Action dialog opens ++(see image). | {{ui:ui-window-placeholder-action-dialog-v4.webp?direct&200}}++ 
-    - Scroll to view the various actions available. In this example use ''Tap'' +    - Scroll to view the various actions available. In this exampleuse ''Tap'' 
-      * Select Tap > ''Action'' to open the Action On Tap dialog: ++(see image) | {{:howto:howto-window-create-object-action-dialog_blurred.webp?direct&200}}++ +      * Select Tap > ''Action'' to open the Action On Tap dialog: ++(see image) | {{:ui-tap_action-tap_selection.webp?direct&200}}++ 
-      * Select Window to open the Window-Portrait dialog ++(see image) | {{:howto:howto-window_create-window_object-window_portrait_dialog.webp?direct&200}}+++      * Select Window to open the Window-Portrait dialog ++(see image) | {{ui:ui-window-portrait-v4.webp.webp?direct&200}}++
       * Scroll the dialog to find and select the example ''App_Widget_Window''       * Scroll the dialog to find and select the example ''App_Widget_Window''
       * TL now returns to the previous Action On Tap dialog (Tap) and shows the tap action will open the ''App_Widget_Window''       * TL now returns to the previous Action On Tap dialog (Tap) and shows the tap action will open the ''App_Widget_Window''
Line 84: Line 78:
   - If the widget was not previously added, it can now be added.   - If the widget was not previously added, it can now be added.
 <WRAP Pagebreak /> <WRAP Pagebreak />
-=== Window: Add an Existing Widget to a Window after the Window Has Been Created ===+===== Window: Add an Existing Widget to a Window after the Window Has Been Created =====
  
   - There are two ways to add an object to a window:   - There are two ways to add an object to a window:
Line 92: Line 86:
   - Enter Edit On mode   - Enter Edit On mode
   - From the top Object Design Menu select the Object Add icon {{ui:ui-icon_add_gray-v4.webp?15}}   - From the top Object Design Menu select the Object Add icon {{ui:ui-icon_add_gray-v4.webp?15}}
-  - The Add dialog opens ++(see image). | {{:howto:howto-window_create-widget-add.webp?direct&200}}++Then ...+  - The Add dialog opens ++(see image). | {{:ui-object_add-selection-v4.webp?direct&200}}++Then ...
       * Select Widget       * Select Widget
       * Select any desired object, but in this procedure, ''App drawer''       * Select any desired object, but in this procedure, ''App drawer''
-        * Note: There are 3 types of application drawers and 1 contact "drawer". Each has its own characteristics which can be confusing when really deep diving into their uniqueness. A full description and disection can be found at [[:section:section-widget|here]] at **Widgets** if desired. +        * Note: There are 3 types of application drawers and 1 contact "drawer". Each has its own characteristicswhich can be confusing when really diving deep into their uniqueness. A full description and dissection can be found at [[:section:section-widget|here]] in **Widgets** if desired. 
-  - The App drawer widget is now on a page, centered. Tap-hold and drag to re-locate so that it does not block access to the other object(s) which will activate the window. +  - The App drawer widget is now on a page, centered. Tap-hold and drag to relocate so that it does not block access to the other object(s) which will activate the window. 
-  - The App drawer widget is on the screen and **is selected**The following steps will place the widget within the window: +  - The App drawer widget is on the screen and **is selected**The following steps will place the widget within the window: 
-    - Tap the Object Design Menu Copy icon {{ui:ui-icon_copy-v4.webp?15}} which will remove the highlighting of the App drawer widget, but will change the Add icon {{ui:ui-icon_add_gray-v4.webp?15}} to a new Add-Paste icon {{ui:ui-icon_add_paste-v4.webp?15}}+    - Tap the Object Design Menu Copy icon {{ui:ui-icon_copy-v4.webp?15}}which will remove the highlighting of the App drawer widget, but will change the Add icon {{ui:ui-icon_add_gray-v4.webp?15}} to a new Add-Paste icon {{ui:ui-icon_add_paste-v4.webp?15}}
     - Now, to paste the copied widget into the window. Open the target window (tap the window widget)     - Now, to paste the copied widget into the window. Open the target window (tap the window widget)
       * In the upper right corner, tap the {{ui:ui-icon_add_paste-v4.webp?15}}       * In the upper right corner, tap the {{ui:ui-icon_add_paste-v4.webp?15}}
-    - From the Add dialog, select ''Paste'' ++(see image) | {{:howto:howto-window_create-widget_add-add_paste_dialog.webp?direct&200}}+++    - From the Add dialog, select ''Paste'' ++(see image) | {{ui:ui-object-paste-add-v4.webp?direct&200}}++
       * The "App_Widget_Window" now contains the App Drawer widget       * The "App_Widget_Window" now contains the App Drawer widget
-    - Close the window by either tapping a blank space outside the window (if the full screen window has been down-sized earlier there should be enough edge space to do so) //or// by swipping right-to-left.+    - Close the window by either tapping a blank space outside the window (if the full-screen window has been downsized earlierthere should be enough edge space to do so) //or// by swiping right-to-left.
     - The page still contains the original App drawer widget. Since that widget is //now// contained in the window, it is proper to delete the original App Drawer widget from the page.     - The page still contains the original App drawer widget. Since that widget is //now// contained in the window, it is proper to delete the original App Drawer widget from the page.
       * In Edit On mode, tap and hold the App Drawer widget to select it.       * In Edit On mode, tap and hold the App Drawer widget to select it.
-      * Fron the Object Design Menu, select the Delete icon {{ui:ui-icon_delete-v4.webp?15}}+      * From the Object Design Menu, select the Delete icon {{ui:ui-icon_delete-v4.webp?15}}
       * The Confirm - Remove Selections dialog opens. Select OK       * The Confirm - Remove Selections dialog opens. Select OK
       * The widget is removed       * The widget is removed
  
 **The project is completed.** **The project is completed.**
-<WRAP center round info 60%> +<WRAP center round info 80%> 
-A [[feature_requests:feature_requests_and_status|#FeatureRequest]] has been made to the Developer to extend the existing ''Action'' > ''Invisible when edit mode is off'' with a ''Launcher action'' toggle.+A [[feature_requests:feature_requests_and_status|#FeatureRequest]] has been submitted to the developer to introduce a Launcher Action that toggles the object'''Action'' > ''Invisible when edit mode is off'' feature. If implemented, it would allow individual objects or groups to be dynamically shown or hidden without relying on complexities of window containers or page-swap workarounds.
 </WRAP> </WRAP>
- 
- 
 <WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP> <WRAP noprint>{{page>site:site-footer-comment_feedback_block}}</WRAP>