Automatically enable and disable read_only or enabled mode when editing contents of certain widgets programmatically

Fixes #33

Author: UnsignedArduino

TkZero/Combobox.py

@@ -69,6 +69,7 @@ def __init__(
         self._style_root = "TCombobox"
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind("<2>", lambda event: self._popup(event=event))
             self.bind("<Control-1>", lambda event: self._popup(event=event))
@@ -102,8 +103,13 @@ def value(self, new_text: str) -> None:
             raise TypeError(
                 f"new_text is not a str! " f"(type passed in: {repr(type(new_text))})"
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -> tuple[str, ...]:

TkZero/Entry.py

@@ -64,6 +64,7 @@ def __init__(
         self._style_root = "TEntry"
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind("<2>", lambda event: self._popup(event=event))
             self.bind("<Control-1>", lambda event: self._popup(event=event))
@@ -95,8 +96,13 @@ def value(self, new_text: str) -> None:
             raise TypeError(
                 f"new_text is not a str! " f"(type passed in: {repr(type(new_text))})"
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def enabled(self) -> bool:

TkZero/Spinbox.py

@@ -67,6 +67,7 @@ def __init__(
         self._style_root = "TSpinbox"
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind("<2>", lambda event: self._popup(event=event))
             self.bind("<Control-1>", lambda event: self._popup(event=event))
@@ -100,8 +101,13 @@ def value(self, new_text: str) -> None:
             raise TypeError(
                 f"new_text is not a str! " f"(type passed in: {repr(type(new_text))})"
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -> tuple[str, ...]:

TkZero/Text.py

@@ -68,6 +68,7 @@ def __init__(
         )
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind("<2>", lambda event: self._popup(event=event))
             self.bind("<Control-1>", lambda event: self._popup(event=event))
@@ -115,8 +116,16 @@ def text(self, new_text: str) -> None:
             raise TypeError(
                 f"new_text is not a str! " f"(type passed in: {repr(type(new_text))})"
             )
+        last_state = "read_only" if self._readonly else self["state"]
+        if self.enable_automatically:
+            self.enabled = True
         self.delete("1.0", tk.END)
         self.insert("1.0", new_text)
+        if self.enable_automatically:
+            if last_state == "read_only":
+                self.read_only = True
+            else:
+                self.configure(state=last_state)
 
     @property
     def cursor(self) -> str:

docs/Combobox.html

@@ -98,6 +98,7 @@ <h1 class="title">Module <code>TkZero.Combobox</code></h1>
         self._style_root = &#34;TCombobox&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -131,8 +132,13 @@ <h1 class="title">Module <code>TkZero.Combobox</code></h1>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -&gt; tuple[str, ...]:
@@ -476,6 +482,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         self._style_root = &#34;TCombobox&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -509,8 +516,13 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -&gt; tuple[str, ...]:

docs/Entry.html

@@ -93,6 +93,7 @@ <h1 class="title">Module <code>TkZero.Entry</code></h1>
         self._style_root = &#34;TEntry&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -124,8 +125,13 @@ <h1 class="title">Module <code>TkZero.Entry</code></h1>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def enabled(self) -&gt; bool:
@@ -438,6 +444,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         self._style_root = &#34;TEntry&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -469,8 +476,13 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def enabled(self) -&gt; bool:

docs/Frame.html

@@ -264,8 +264,8 @@ <h1 class="title">Module <code>TkZero.Frame</code></h1>
             &#34;&lt;KeyRelease-Shift_R&gt;&#34;, lambda _: self._set_shift_pressed(False)
         )
         self._hovering_over = False
-        self.frame.bind(&#34;&lt;Enter&gt;&#34;, lambda _: self._set_hover_state(True))
-        self.frame.bind(&#34;&lt;Leave&gt;&#34;, lambda _: self._set_hover_state(False))
+        self.frame.bind(&#34;&lt;Enter&gt;&#34;, lambda _: self._set_hover_state(True), add=True)
+        self.frame.bind(&#34;&lt;Leave&gt;&#34;, lambda _: self._set_hover_state(False), add=True)
 
     def _set_shift_pressed(self, is_pressed: bool) -&gt; None:
         &#34;&#34;&#34;
@@ -844,8 +844,8 @@ <h3>Methods</h3>
             &#34;&lt;KeyRelease-Shift_R&gt;&#34;, lambda _: self._set_shift_pressed(False)
         )
         self._hovering_over = False
-        self.frame.bind(&#34;&lt;Enter&gt;&#34;, lambda _: self._set_hover_state(True))
-        self.frame.bind(&#34;&lt;Leave&gt;&#34;, lambda _: self._set_hover_state(False))
+        self.frame.bind(&#34;&lt;Enter&gt;&#34;, lambda _: self._set_hover_state(True), add=True)
+        self.frame.bind(&#34;&lt;Leave&gt;&#34;, lambda _: self._set_hover_state(False), add=True)
 
     def _set_shift_pressed(self, is_pressed: bool) -&gt; None:
         &#34;&#34;&#34;

docs/Spinbox.html

@@ -96,6 +96,7 @@ <h1 class="title">Module <code>TkZero.Spinbox</code></h1>
         self._style_root = &#34;TSpinbox&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -129,8 +130,13 @@ <h1 class="title">Module <code>TkZero.Spinbox</code></h1>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -&gt; tuple[str, ...]:
@@ -473,6 +479,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         self._style_root = &#34;TSpinbox&#34;
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -506,8 +513,13 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_states = self.state()
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(0, tk.END)
         self.insert(0, new_text)
+        if self.enable_automatically:
+            self.state(last_states)
 
     @property
     def values(self) -&gt; tuple[str, ...]:

docs/Text.html

@@ -97,6 +97,7 @@ <h1 class="title">Module <code>TkZero.Text</code></h1>
         )
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -144,8 +145,16 @@ <h1 class="title">Module <code>TkZero.Text</code></h1>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_state = &#34;read_only&#34; if self._readonly else self[&#34;state&#34;]
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(&#34;1.0&#34;, tk.END)
         self.insert(&#34;1.0&#34;, new_text)
+        if self.enable_automatically:
+            if last_state == &#34;read_only&#34;:
+                self.read_only = True
+            else:
+                self.configure(state=last_state)
 
     @property
     def cursor(self) -&gt; str:
@@ -517,6 +526,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         )
         self._enabled = True
         self._readonly = False
+        self.enable_automatically = True
         if on_aqua(self):
             self.bind(&#34;&lt;2&gt;&#34;, lambda event: self._popup(event=event))
             self.bind(&#34;&lt;Control-1&gt;&#34;, lambda event: self._popup(event=event))
@@ -564,8 +574,16 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             raise TypeError(
                 f&#34;new_text is not a str! &#34; f&#34;(type passed in: {repr(type(new_text))})&#34;
             )
+        last_state = &#34;read_only&#34; if self._readonly else self[&#34;state&#34;]
+        if self.enable_automatically:
+            self.enabled = True
         self.delete(&#34;1.0&#34;, tk.END)
         self.insert(&#34;1.0&#34;, new_text)
+        if self.enable_automatically:
+            if last_state == &#34;read_only&#34;:
+                self.read_only = True
+            else:
+                self.configure(state=last_state)
 
     @property
     def cursor(self) -&gt; str: