pyTermTk/docs/MDNotes/internals/focus.keypress.md

Current

Current Status of the focus/keypress logic

<INPUT>
  └─▶ KeyEvent
        └─▶ TTk._key_event()
              try 1 ─▶ send KeyEvent to Focus Widget
              try 2 ─▶ send KeyEvent to Shortcut Engine
              try 3 ─▶ Check and handle for next Focus
              try 4 ─▶ check and handle for prev focus

Reworked Status of the focus/keypress logic

1. Add default KeyPress handler

   This handler is supposed to switch the focus (next/prev) or return False

2. Add focus proxy/orchestrator/helper in TTkContainer (New Class? or internally Managed?)

   ####ß Require (so far)

   • Next Focus
   • Prev Focus
   • First Focus
   • Last Focus
   • Get Focussed
   • Focus Widget
   • UnFocus Widget
   • Add Widget(s)
   • Remove Widget(s)
   • Insert Widget(s)

3. Key Propagation

   <INPUT>
   └─▶ KeyEvent
           └─▶ TTk.keyEvent(kevt)
               try 1 ─▶ send KeyEvent to
                           └─▶ super().keyEvent(kevt) (TTkContainer)
                               try 1 : send key event to the focussed
                                 if return False;
                               try 2 : if  Tab/Right focus Next
                               try 3 : if ^Tab/Left  focus Prev
                               If nothing execute return False
                 if not handled, the tab/direction key switch reached the last/first widget:
               try 3 ─▶  Tab/Right focus the first
               try 4 ─▶ ^Tab/Left  focus the last
   

4. Focus Propagation

TODO

• - Implement root handler to handle overlay widgets where the focus switch should be contained in the overlay
• - Remove nextFocus,prevFocus from the helper
• - Investigate other widgets focus propagation
• - Switch Focus to the menu
• - Type TTkLayout and add docstrings
• - Add deprecated methods in ttkhelper
• - Investigate lineedit of the combobox
• - Tab Widget: Adapt to the new logic
• - DateTime: Adapt to the new logic
• - Tab Widget: Apply Highlight colors