IiS?dZddlmZddlmZddlmZddlZGddeZGdd eZ Gd d eZ Gd d Z GddZ Gdde ejZGdde ejZgdZy)a} Selection management for wxPython list controls. Provides mixins and ready-to-use controls that automatically manage selection state for list controls: - Auto-focus first item when control gains focus with no selection - Maintain valid selection after item deletion (configurable: previous/next) - Optionally auto-focus newly added items Includes: - ListBoxSelectionManagerMixin: For wx.ListBox-style controls - ListCtrlSelectionManagerMixin: For wx.ListCtrl/wx.ListView-style controls - ManagedListBox: Ready-to-use non-checkable single-column list - ManagedListCtrl: Ready-to-use non-checkable multi-column list Requires: wxPython ) annotations)Enum)AnyNceZdZdZdZdZy)FocusAfterDeletez+Where to move focus after deleting an item.previousnextN)__name__ __module__ __qualname____doc__PREVIOUSNEXTKC:\Users\dbart\PlayPalace11\clients\desktop\ui\enhance_wx\list_selection.pyrr s5H DrrceZdZdZdZdZy) FocusAfterAddz)Where to move focus after adding an item.newstayN)r r r r NEW_ITEMSTAYrrrrr's3H DrrceZdZdZdZdZdZy) ColumnWidthz%Column width modes for list controls. auto_content auto_headerfillN)r r r r AUTO_CONTENT AUTO_HEADERFILLrrrrr.s/!LK DrrceZdZdZej ejd d fdZd dZ d fd Z d fd Z dfd Z dfd Z dfd ZxZS)ListBoxSelectionManagerMixina+ Mixin that manages selection for wx.ListBox-style controls. Features: - Auto-selects first item when focused with no selection - Maintains valid selection when items are deleted - Optionally focuses new items when added Works with: wx.ListBox and subclasses. Note: While this mixin works with wx.CheckListBox, that control has accessibility limitations. For checkable lists, use AccessibleCheckListCtrl() instead, which provides this same selection management with better accessibility. Args: focus_after_delete: Where to focus after deleting an item. FocusAfterDelete.PREVIOUS (default) or FocusAfterDelete.NEXT focus_after_add: Where to focus after adding an item. FocusAfterAdd.NEW_ITEM (default) or FocusAfterAdd.STAY )focus_after_deletefocus_after_addct||i|||_||_d|_|j t j|jy)NF) super__init__r#r$_suppress_auto_selectBindwx EVT_SET_FOCUS_on_focus_ensure_selection)selfr#r$argskwargs __class__s rr'z%ListBoxSelectionManagerMixin.__init__QsI $)&)"4.%*" """D$C$CDrc|j|jry|jdkDr4|jtj k(r|j dyyy)BAuto-select first item when control gains focus with no selection.Nr)Skipr(GetCount GetSelectionr* NOT_FOUND SetSelectionr-evts rr,z7ListBoxSelectionManagerMixin._on_focus_ensure_selection^sP   % %  ==?Q 4#4#4#6",,#F   a $G rcH|j|k(}d|_ t| ||rb|j }|dkDrM|j t jk(rtd|dz }nt||dz }|j|d|_y#d|_wxYw))Delete item and maintain valid selection.TrFN) r5r(r&Deleter4r#rrmaxminr7)r-n was_selected new_count new_selectionr0s rr=z#ListBoxSelectionManagerMixin.Deletefs((*a/ %)" / GN1  MMO q=..2B2K2KK(+Aq1u (+Ay1}(= %%m4).D &D &s A3B B!c"t|y)zClear all items.N)r&Clearr-r0s rrEz"ListBoxSelectionManagerMixin.Clearws   rc|jdk(}t| |}|s|jtj k(r"|j |jdz |S)z%Append item and optionally select it.rr<)r4r&Appendr$rrr7)r-item was_emptyresultr0s rrHz#ListBoxSelectionManagerMixin.Append{sUMMOq( % ,, 0F0FF   dmmo1 2 rc|jdk(}t| ||}|s|jtj k(r|j ||S)%Insert item and optionally select it.r)r4r&Insertr$rrr7)r-rIposrJrKr0s rrNz#ListBoxSelectionManagerMixin.InsertsLMMOq( c* ,, 0F0FF   c " rc|j}t| ||jdkDrE|tj k7rt ||jdz }nd}|j|yy)z5Replace all items and maintain selection if possible.rr<N)r5r&Setr4r*r6r?r7)r-items old_selectionrCr0s rrQz ListBoxSelectionManagerMixin.Setsf))+   E ==?Q  , #M4==?Q3F G !   m , r) r.rr#rr$rr/rreturnNoner9z wx.FocusEventrTrU)r@intrTrU)rTrU)rIstrrTrW)rIrXrOrWrTrW)rRz list[str]rTrU)r r r r rrrrr'r,r=rErHrNrQ __classcell__r0s@rr"r";s{00@/H/H)6)?)? E E- E' E  E  E!/" - -rr"ceZdZUdZded<ded<ej ejf d dZ d dZ d fd Z dfd Z dfd Z xZS)ListCtrlSelectionManagerMixinaV Mixin that manages selection for wx.ListCtrl/wx.ListView-style controls. Features: - Auto-selects first item when focused with no selection - Maintains valid selection when items are deleted - Optionally focuses new items when added Works with: wx.ListCtrl, wx.ListView, and subclasses. Args: focus_after_delete: Where to focus after deleting an item. FocusAfterDelete.PREVIOUS (default) or FocusAfterDelete.NEXT focus_after_add: Where to focus after adding an item. FocusAfterAdd.NEW_ITEM (default) or FocusAfterAdd.STAY rr#rr$c||_||_d|_|jtj |j y)z6Initialize selection manager. Call this from __init__.FN)r#r$r(r)r*r+r,)r-r#r$s r_init_selection_managerz5ListCtrlSelectionManagerMixin._init_selection_managers6 #5.%*" """D$C$CDrc|j|jry|jdkDr7|jdk(r#|j d|j dyyy)r2Nr)r3r( GetItemCountGetFirstSelectedSelectFocusr8s rr,z8ListCtrlSelectionManagerMixin._on_focus_ensure_selectionsW   % %      "t'<'<'>"'D KKN JJqM(E "rcl|j|}d|_ t| |}|ru|rs|j }|dkDr^|j t jk(rtd|dz }nt||dz }|j||j|d|_|S#d|_wxYw)r;Trr<F) IsSelectedr(r& DeleteItemrar#rrr>r?rcrd)r-rIrArKrBrCr0s rrgz(ListCtrlSelectionManagerMixin.DeleteItemst, %)" /W'-F, --/ q=..2B2K2KK(+Atax(8 (+D)a-(@ KK .JJ}-).D & */D &s BB** B3c t|S)zDelete all items.)r&DeleteAllItemsrFs rriz,ListCtrlSelectionManagerMixin.DeleteAllItemssw%''rc|jdk(}t||i|}|dk7rA|s|jtj k(r"|j ||j||S)rMrr`)rar& InsertItemr$rrrcrd)r-r.r/rJrKr0s rrkz(ListCtrlSelectionManagerMixin.InsertItemsd%%'1, #T4V4 R<D00M4J4JJ F# 6" r)r#rr$rrTrUrV)rIrWrTbool)rTrl)r.rr/rrTrW)r r r r __annotations__rrrrr^r,rgrirkrYrZs@rr\r\si$)(""0@/H/H)6)?)? E, E' E  E&(rr\ceZdZdZy)ManagedListBoxa A wx.ListBox with automatic selection management. RECOMMENDED: Use this for all non-checkable single-column lists. ================================================================= This is the preferred control for simple lists without checkboxes. It's lightweight, uses the native platform listbox, and is already fully accessible to screen readers. Do NOT use ManagedListCtrl for simple single-column lists - that control is only appropriate for multi-column non-checkable lists. Features: - Auto-selects first item when focused with no selection - Maintains valid selection when items are deleted - Optionally focuses new items when added - Native platform appearance and full accessibility Args: parent: Parent window choices: Initial list of items (optional) focus_after_delete: Where to focus after deleting an item. FocusAfterDelete.PREVIOUS (default) or FocusAfterDelete.NEXT focus_after_add: Where to focus after adding an item. FocusAfterAdd.NEW_ITEM (default) or FocusAfterAdd.STAY name: Accessible name for the control (recommended for screen readers) Usage: fruits = ManagedListBox( parent, choices=["Apple", "Banana", "Cherry"], name="Fruit selection", ) fruits.Append("Date") # Auto-focuses new item fruits.Delete(0) # Auto-focuses appropriate neighbor N)r r r r rrrroros #J rroceZdZdZej ej ejeje je jdf dfd Z ejf ddZd d dZd dZxZS) ManagedListCtrla8 A wx.ListView with automatic selection management for multi-column lists. USE CASE: Multi-column non-checkable lists only. ================================================= This control is for lists that need multiple columns but no checkboxes (e.g., file browsers with Name/Size/Date columns). For single-column non-checkable lists, use ManagedListBox instead. For any checkable list (single or multi-column), use AccessibleCheckListCtrl. Features: - Auto-selects first item when focused with no selection - Maintains valid selection when items are deleted - Optionally focuses new items when added - Auto-sizing columns with ColumnWidth enum - Configurable visible row count with SetVisibleRowCount() Args: parent: Parent window focus_after_delete: Where to focus after deleting an item. FocusAfterDelete.PREVIOUS (default) or FocusAfterDelete.NEXT focus_after_add: Where to focus after adding an item. FocusAfterAdd.NEW_ITEM (default) or FocusAfterAdd.STAY show_header: Whether to show column headers. name: Accessible name for the control (recommended for screen readers) Usage: files = ManagedListCtrl(parent, name="File list") files.AppendColumn("Name", ColumnWidth.AUTO_CONTENT) files.AppendColumn("Size", width=80) files.AppendColumn("Modified", ColumnWidth.FILL) files.InsertItem(0, "document.txt") files.SetItem(0, 1, "4 KB") files.SetItem(0, 2, "2024-01-15") files.AutoSizeColumns() Tc  |s|tjz}t | |||||fi| |j ||d|_g|_||_y)Nr)r* LC_NO_HEADERr&r'r^ _column_count_column_widths _show_header) r-parentidrOsizestyler#r$ show_headerr/r0s rr'zManagedListCtrl.__init__8sY R__ $E S$@@ $$%7I79'rcZt|trK|tjk(rtj}n)|tj k(rtj }nd}n|}|j|j|||jj||xjdz c_y)z Add a column to the list. Args: heading: Column header text width: Column width - can be int or ColumnWidth enum r`)widthr<N) isinstancerrr* LIST_AUTOSIZErLIST_AUTOSIZE_USEHEADER InsertColumnrtruappend)r-headingr} initial_widths r AppendColumnzManagedListCtrl.AppendColumnLs e[ ) 000 " 0 0 +111 " : : " !M $,,g]K ""5) arcBtjD]tjkrjntj }t |trw|tjk(rdjj}tfdtjD}td||z }j||r!jtjjtjy)z(Resize all columns to fit their content.c3LK|]}|k7s j|yw)N)GetColumnWidth).0ccolr-s r z2ManagedListCtrl.AutoSizeColumns..os*'4MqQRVYQYD''*4Ms $$2N)rangertlenrurrr~r GetClientSizer}sumr>SetColumnWidthr*rr)r- use_headeroriginal_width total_widthother_cols_width fill_widthrs` @rAutoSizeColumnszManagedListCtrl.AutoSizeColumnsds++,CT0011##C( --  .+6>[M]M];]"00288 #&'49$:L:L4M'$ ![3C%CD ##C4##C)C)CD##C)9)9:#-rctd|}|jdkDr|jd}|j}nKt j |}|j |j|jdddz}d}|jrKt j |}|j |j|jdddz}||z|zdz}|j}|jt j|j||jt j|j|y)z8Set control height to show approximately this many rows.r<rTgN)r>ra GetItemRectheightr*ClientDCSetFontGetFont GetTextExtentrvGetSize SetMinSizeSizer}SetSize)r-rows item_rect item_heightdc header_height total_height current_sizes rSetVisibleRowCountz"ManagedListCtrl.SetVisibleRowCountys1d|     "((+I#**KT"B JJt||~ &**403a7K   T"B JJt||~ &,,T2159M{*m;a? ||~   2 2LAB RWW\//>?r)rwz wx.WindowrxrWrOzwx.Pointryzwx.SizerzrWr#rr$rr{rlr/rrTrU)rrXr}zint | ColumnWidthrTrU)F)rrlrTrU)rrWrTrU)r r r r r*ID_ANYDefaultPosition DefaultSize LC_REPORTrrrrr'rrrrrrYrZs@rrqrqs$R))**\\/?/H/H)6)?)? (( ( (  (  (-('((( (*8C7O7O  #4  0;*@rrq)rrrr"r\rorq)r __future__renumrtypingrr*rrrr"r\ListBoxroListViewrq__all__rrrrs$# tD$Y-Y-xIIb& 12::& R~@3R[[~@B r