Fix/155 windows default skin

TkEasyGUI/utils.py

@@ -259,8 +259,6 @@ def set_default_theme() -> None:
         set_theme("aqua")
     elif is_win():
         # ('winnative', 'clam', 'alt', 'default', 'classic', 'vista', 'xpnative')
-        # set_theme("winnative")
-        # set_theme("default")
         set_theme("vista")
     else:
         set_theme("clam")

TkEasyGUI/widgets.py

@@ -2337,6 +2337,7 @@ class Button(Element):
 
     **Example**
     The program below changes the button's label to "Pushed" when the button is pressed.
+
     ```python
     import TkEasyGUI as eg
     button:eg.Button = eg.Button("Push me")
@@ -2346,6 +2347,12 @@ class Button(Element):
                 button.set_text("Pushed")
                 break
     ```
+
+    `use_ttk_buttons` parameter is set to `True` by default, which makes buttons look more modern.
+    However, on macOS, the default `ttk.Button` has a gray background and does not support changing the background color.
+    If you want to change the button color on macOS, set `use_ttk_buttons=False` to use `tk.Button` instead.
+    Also, when `use_ttk_buttons=True`, explicit button height settings are ignored due to a `ttk` limitation.
+    If you need to control button height, set `use_ttk_buttons=False`.
     """
 
     # pylint: disable=too-many-arguments, too-many-locals
@@ -2363,22 +2370,21 @@ def __init__(
         font: Optional[FontType] = None,  # font
         color: Optional[str] = None,  # text color
         text_color: Optional[str] = None,  # same as color
-        background_color: Optional[
-            str
-        ] = None,  # background color (not supported on macOS)
+        background_color: Optional[str] = None,  # background color (not supported on macOS)
         # pack props
         expand_x: bool = False,
         expand_y: bool = False,
         pad: Optional[PadType] = None,
         # other
-        use_ttk_buttons: bool = False,
+        use_ttk_buttons: bool = True,
         metadata: Optional[dict[str, Any]] = None,
         **kw,
     ) -> None:
         """Create a Button element."""
         key = button_text if (key is None) or (key == "") else key
         super().__init__("Button", "TButton", key, False, metadata, **kw)
-        self.use_ttk = use_ttk_buttons  # can select ttk or tk button
+        # On Windows, ttk buttons look more modern by default.
+        self.use_ttk = use_ttk_buttons
         self.disabled = False
         if disabled is not None:
             self.props["disabled"] = self.disabled = disabled

TkEasyGUI/widgets_window.py

@@ -52,6 +52,8 @@ def _create_root(self) -> tk.Tk:
             self._root.eval("tk::PlaceWindow . center")
             self._root.withdraw()
         if self._theme_name == "":
+            # windows: winnative, clam, alt, default, classic, vista, xpnative
+            # macOS: aqua, clam, alt, default, classic
             if _is_mac():
                 self.set_theme("aqua")
             elif _is_win():

docs/README.md

@@ -68,6 +68,7 @@ Here is a list of elements:
 ### TkEasyGUI Original features
 
 - [Custom Events](https://github.com/kujirahand/tkeasygui-python/blob/main/docs/custom_events.md)
+- [Theme Guide](https://github.com/kujirahand/tkeasygui-python/blob/main/docs/theme.md)
 
 ### Package developper
 

docs/theme.md

@@ -0,0 +1,115 @@
+# TkEasyGUI Theme Guide
+
+This document explains how to use themes and how to change theme-related defaults in TkEasyGUI.
+
+## Overview
+
+TkEasyGUI uses `ttk` themes for modern widget rendering.
+You can switch themes at runtime using `set_theme()` or `theme()`.
+
+Default theme by platform:
+
+- macOS: `aqua`
+- Windows: `vista`
+- Linux/others: `clam`
+
+## Basic theme usage
+
+### Change theme with `set_theme`
+
+```python
+import TkEasyGUI as eg
+
+eg.set_theme("clam")
+window = eg.Window("Theme sample", [[eg.Button("OK", use_ttk_buttons=True)]])
+window.read()
+window.close()
+```
+
+### Alias: `theme`
+
+`theme()` is an alias of `set_theme()`.
+
+```python
+import TkEasyGUI as eg
+
+eg.theme("default")
+```
+
+## List available themes
+
+Use `get_tnemes()` to inspect themes available in your current Tk runtime.
+
+```python
+import TkEasyGUI as eg
+
+print(eg.get_tnemes())
+```
+
+Note:
+- Function name is `get_tnemes()` in current API.
+
+## Change button style behavior
+
+`Button` can render with `ttk.Button` (modern) or `tk.Button` (classic).
+
+- `use_ttk_buttons=True`: use `ttk.Button`
+- `use_ttk_buttons=False`: use `tk.Button`
+- `use_ttk_buttons=None` (default): Windows uses `ttk`, other OS keep previous default behavior
+
+```python
+import TkEasyGUI as eg
+
+layout = [
+    [eg.Button("Modern", use_ttk_buttons=True)],
+    [eg.Button("Classic", use_ttk_buttons=False)],
+]
+window = eg.Window("Buttons", layout)
+window.read()
+window.close()
+```
+
+Note:
+- If you set `use_ttk_buttons=True`, explicit button height settings are ignored.
+- This is a limitation of `ttk`.
+- If you need to control button height, use `use_ttk_buttons=False`.
+
+
+
+
+## How to customize defaults
+
+### Global theme default
+
+If you want to change the default theme for your app, call `set_theme()` before creating windows.
+
+```python
+import TkEasyGUI as eg
+
+eg.set_theme("winnative")
+```
+
+### Revert to old Windows look
+
+If you want behavior close to older Windows appearance:
+
+```python
+import TkEasyGUI as eg
+
+eg.set_theme("vista")
+layout = [[eg.Button("OK", use_ttk_buttons=False)]]
+window = eg.Window("Legacy look", layout)
+window.read()
+window.close()
+```
+
+## Recommended test scripts
+
+After changing theme defaults, validate with:
+
+```bash
+python tests/file_viewer.py
+python tests/theme/ttk_button.py
+python tests/ui_test.py
+python tests/many_buttons.py
+```

tests/theme/ttk_button.py

@@ -0,0 +1,18 @@
+"""Compare ttk and classic button rendering."""
+
+import TkEasyGUI as eg
+
+layout = [
+    [eg.Text("This is a modern button using ttk styles.")],
+    [eg.Button("Modern", use_ttk_buttons=True)],
+    [eg.HSeparator()],
+    [eg.Text("This is a classic button using Tkinter styles.")],
+    [eg.Button("Classic", use_ttk_buttons=False)],
+]
+window = eg.Window("Buttons", layout)
+for event, values in window.event_iter():
+    if event == "Modern":
+        eg.popup("You clicked the modern button!")
+    if event == "Classic":
+        eg.popup("You clicked the classic button!")
+window.close()