Maliang

🕓 *Release Date / 发布日期 : 2025-01-26*

🟢 **Added / 新增**

* Add methods `get` and `set` to some widgets
给一些控件增加方法 `get` 和 `set`

* A new parameter `auto_detect` has been added to the method `bind` of the widgets to determine whether to automatically check the location of the decision
新参数 `auto_detect` 已添加到控件的方法 `bind` 中，以确定是否自动检查决策的位置

* Add methods `modified` and `transparent` to class `Tk`
给类 `Tk` 增加了方法 `modified` 和 `transparent`
Pull Request: 65 Contributor: CodeCrafter-TL

🟣 **Fixed / 修复**

* Fix a bug where calling function `apply_theme` in non-Windows systems caused unnecessary warnings
修复了在非 Windows 系统中调用函数 `apply_theme` 导致不必要警告的错误

* Fix a bug where the optional package `darkdetect` can not be imported on some Windows platforms
修复了在某些 Windows 平台无法导入包 `darkdetect` 的问题

* Fix a bug where the widgets `ComboBox` and `OptionButton` can be obscured by other widgets
修复了控件 `ComboBox` 和 `OptionButton` 可能被其他控件遮挡的问题

🟡 **Changed / 变更**

* Improve the color style of the widget `SegmentedButton` and its related widgets
改进控件 `SegmentedButton` 及其相关控件的颜色样式

🟤 **Refactored / 重构**

* Change some code written with module `platform` to module `sys` to provide better type hints
将部分用模块 `platform` 写的代码改用模块 `sys` 重写来提供更好的类型提示

🕓 *Release Date / 发布日期 : 2025-01-13*

🟢 **Added / 新增**

* Add disabled mouse cursor styles
新增控件禁用状态时的鼠标样式

* Add function `create_smoke` to create translucent rectangular areas
新增函数 `create_smoke` 来创建半透明的矩形区域

* Add widget virtual composition class `virtual.Style` to control the style of a widget
新增控件虚拟组成类 `virtual.Style` 来控制一个控件的样式

* Add a new submodule `standard.styles`
新增模块 `standard.styles`

* Add method `set` to class `Style` to quickly modify the style of the widget
类 `Style` 新增方法 `set` 来快速修改控件样式

* Add a new experimental image element `Smoke`
增加了一个实验性的图片元素 `Smoke`

* Add an experimental parameter `zoom_all_items` to `Canvas`
增加了一个实验性参数 `zoom_all_items` 给 `Canvas`

* Add method `skip` to class `Animation` to skip some loops
增加了方法 `skip` 来跳过类 `Animation` 的一些循环

* Add the ability to use the with statement to the containers
容器控件现在可以使用 with 语句来临时创建并删除了

* Add a new theme `"acrylic2"` to function `apply_theme`
函数 `apply_theme` 新增配置选项 `"acrylic2"`

* `Canvas` now supports automatic get the default master
`Canvas` 现在可以自动获取默认的父控件了

* Now can specify the style to modify a theme
现在修改单个控件的主题时可以指定某个主题了

🟣 **Fixed / 修复**

* Fix a bug where classes `Tk` and `Toplevel` may not work on Linux platforms
修复了类 `Tk` 和类 `Toplevel` 可能无法在 Linux 平台上无法运行的 bug

* Fix class `animations.MoveWindow` may report an error when passing in certain parameters
修复了类 `animations.MoveWindow` 传入某些参数时可能报错的 bug

* Fix a bug where widgets would flicker unexpectedly when changing colors
修复了修改控件颜色时会意外闪烁的 bug

* Fix a bug where the animation did not completely stop when the `Element` was destroyed
修复了元素删除时其动画不会停止的 bug

* Fix a bug where widgets don't scale their nested widgets in some cases
修复了控件在某些情况下不会缩放其嵌套控件的 bug

* Fix a bug where the coordinates of the Image element were incorrectly detected
修复了元素 `Image` 的坐标被错误检测的 bug

* Fix a bug where the registered theme processing event was not deleted when the root window was deleted
修复了当根窗口被删除时其注册的样式处理事件没有被删除的 bug

* Fixed a bug where the function `get_text_size` return value is inaccurate
修复了函数 `get_text_size` 返回值在某些情况下不不准确的 bug

* Fix a bug where deleting a `Canvas` would not automatically delete the `Widget`, resulting in the widget's animation not automatically terminating
修复了删除 `Canvas` 不会自动删除 `Widget` 的错误，从而导致 Widget 的动画不会自动终止

* Fix a bug where style switch of `containers.Tk` does not automatically take effect on child windows
修复了类 `containers.Tk` 的样式切换时不会应用于子窗口的 bug

* Fix a bug where some of methods of containers.Tk do not work on non-Windows systems
修复 `containers.Tk` 的部分方法无法在非 Windows 平台上生效的 bug

* Fix the bug that function `load_font` can not take effect in some cases under the Linux platform
修复了某些情况下函数 `load_font` 无法在 Linux 平台上生效的 bug

* Fix a bug where function `apply_theme` do not take effect when the parameter is `"mica"`
修复了函数 `apply_theme` 在 Windows 平台上输入参数 `"mica"` 时无效的 bug

* Fix a bug where the icon of the window can not be set on the Linux platform
修复了在 Linux 平台下窗口的图标无法设置的 bug

* A new method `group` has been added to the `RadioBox` widget to combine other radio widgets
控件 `RadioBox` 新增方法 `group` 来绑定其它单选框控件

* Fix a bug where an error is reported when auto-calculating styles in the disabled state due to the inability to process empty strings
修复了控件在禁用状态自动计算状态时因传入空字符串而报错的 bug

* Fix a bug where the selected part of the text box has a border
修复了文本框在选中文本时有一个边框的 bug

* Fix a bug where Canvas initialization failed in some cases
修复了某些情况下画布在初始化时会失败的 bug

* Fix a bug where the window size would change when the title bar is hidden
修复了隐藏窗口标题栏时窗口大小会改变的 bug

* Fix a bug where an error is reported when disabling widgets with `Image` elements
修复了禁用含图片元素的控件时会报错的 bug

* Fix a bug where the default font on macOS platform is not recognized by `matplotlib`
修复了在 macOS 平台上的默认字体无法被 `matplotlib` 包识别的 bug

🔵 **Optimized / 优化**

* Change some `update_idletasks` to `update` to improve speed performance
修改了部分 `update_idletasks` 为 `update` 来提升性能

🔴 **Removed / 移除**

* Removed class `Frame` and its styles
移除了类 `Frame` 及其样式

* Removed the **original** subpackage `theme`
移除了**原来的**子包 `theme`

🟤 **Refactored / 重构**

* Refactor subpackage `color`
重构了子包 `color`

* Refactor submodule `animation`
重构了子包 `animation`

* Refactor submodule `configs`
重构了子模块 `configs`

* Refactor submodule `containers`
重构了子模块 `containers`

* Refactor style control mechanism
重构了样式控制机制

* Refactor subpackage `style` and renamed to `theme`
重构子包 `style` 并重命名为 `theme`

* Refactor widget `RadioButton` and renamed to `RadioBox`
重构控件 `RadioButton` 并重命名为 `RadioBox`

* Refactor widget `CheckButton` and renamed to `CheckBox`
重构控件 `CheckButton` 并重命名为 `CheckBox`

🕓 *Release Date / 发布日期 : 2024-12-19*

🟢 **Added / 新增**

* A new property `is_active` has been added to the class `Animation` to represent the state of the animation
类 `Animation` 新增了一个属性 `is_active` 表征动画的状态

* Class `virtual.Widget` has a new method `is_nested` to determine if the widget is nested
类 `virtual.Widget` 新增了一个方法 `is_nested` 来判断该控件是否为嵌套控件

* Added the global configuration option `enable_animation` to enable the color gradient animation of the widget
新增全局配置选项 `enable_animation` 来设置控件颜色渐变动画是否启用

* New widget: `OptionButton`
新增控件：选项按钮（`OptionButton`）

* New widget: `ComboBox`
新增控件：下拉框（`ComboBox`）

* New widget: `Spinner`
新增控件：旋转条（`Spinner`）

* Classes `Tk` and `Toplevel` added the parameter `icon` to set the icon of the window
类 `Tk` 和 `Toplevel` 新增了参数 `icon` 来设置窗口的图标

* Class `texts.SingleLineText` added a new parameter `limit_width` to show the maximum width of the text display
类 `texts.SingleLineText` 新增了参数 `limit_width` 来显示文本显示的最大宽度

🟣 **Fixed / 修复**

* Fixed a bug where the parameter `end` of the class `Animation` was called with an error causing the animation to terminate
修复了类 `Animation` 的参数 `end` 被调用时产生错误导致动画终止的 bug

* Fixed a bug where the default root window could not be obtained in some cases
修复了某些情况下无法获取默认根窗口的 bug

* Fixed a bug where the content of the class `virtual.Text` could not be changed when the parameter `limit` was negative
修复了类 `virtual.Text` 的参数 `limit` 为负数时，内容无法更改的 bug

* Fixed a bug where the method `detect` for nested widgets had inaccurate results
修复了嵌套控件的方法 `detect` 结果不准确的 bug

* Fixed a bug where the method `update` of nested widgets sometimes did not take effect
修复了嵌套控件的方法 `update` 有时不生效的 bug

* Fixed a bug where nested widgets could not be disabled
修复了嵌套控件无法禁用的 bug

* Fixed a bug where the placeholder character of the widget `InputBox` would sometimes be displayed at the same time as the text content
修复了控件 `InputBox` 的占位字符有时会和文本内容同时显示的 bug

* Fixed a bug where the parameter `through` of the widget `SpinBox` was passed incorrectly
修复了控件 `SpinBox` 的参数 `through` 传递不正确的 bug

* Fixed a bug where the `anchor` parameter of the widget `SpinBox` did not take effect
修复了控件 `SpinBox` 的参数 `anchor` 不生效的 bug

* Fixed a bug where the text of the widget `SpinBox` was obscured by the numeric adjustment button
修复了控件 `SpinBox` 的文本被数值调节按钮遮挡的 bug

🔵 **Optimized / 优化**

* Invisible widgets are no longer handled by the event handling mechanism
不可见的控件现在不会被事件处理机制处理了

🕓 *Release Date / 发布日期 : 2024-11-17*

🟢 **Added / 新增**

* The fine-grained scaling of widgets has been improved, and the position and size of the widgets can now be scaled separately by the new parameters of the method `zoom` of widgets, as described in the documentation
提高了控件缩放的细粒度，现在可以通过控件的 `zoom` 方法的新参数分别缩放控件的位置和大小，具体参数见文档

* Added parameters to the widget `SpinBox` to control the size of each time the value is modified and the format in which the value is displayed, see the documentation
控件 `SpinBox` 新增参数来控制每次修改值时的大小以及值显示的格式，具体参数见文档

* The widget `InputBox` adds the ability of key <kbd>Del</kbd> to delete text
控件 `InputBox` 新增 <kbd>Del</kbd> 键的功能来删除文本

🔵 **Optimized / 优化**

* The function `controllers.controller_generator` now warn when a parameter passed to function is inappropriate
现在传递给函数 `controllers.controller_generator` 的参数不合适时会发出警告

* Now use the descriptor to get the default root window dynamically
现在使用描述器来动态获取默认的根窗口

* The time error of the animation has been reduced
减小了动画的时间误差

* Improved type hints
改善类型提示

* Improved code style
改善代码风格

🟣 **Fixed / 修复**

* Fixed a bug where the widget `SegmentedButton` would show the wrong position when using the `anchor` parameter
修复了控件 `SegmentedButton` 使用参数 `anchor` 时会显示错位的 bug

* Fixed a bug where nested widgets could not be destroyed gracefully
修复了嵌套控件无法正常删除的 bug

* Fixed a bug where it was not possible to delete a widget with a lower creation order widget
修复了无法用创建顺序靠后的控件去删除创建顺序靠前的控件的 bug

* Fixed a bug where the widget `InputBox` could produce an error when deleting text
修复了控件 `InputBox` 在删除文本时可能产生错误的 bug

* Fixed a bug where the widget `InputBox` could produce an error when using the experimental Select All feature
修复了控件 `InputBox` 在使用实验性全选功能时可能产生错误的 bug

* Fixed a bug where the widget `SpinBox` would produce an error when using the built-in adjustment value feature
修复了控件 `SpinBox` 在使用自带的调节值功能时会产生错误的 bug

🟤 **Refactored / 重构**

* Refactored submodule `core.constants` and renamed to `core.configs`
重构子模块 `core.constants` 并重命名为 `core.configs`

* Refactoring the entire event handling mechanism to now bind and handle events almost exactly like native `tkinter`
重构整个事件处理机制，现在几乎可以完全像原生 `tkinter` 那样绑定和处理事件了

🔴 **Removed / 移除**

* Removed useless submodule `standard._auxiliary`
移除了无用子模块 `standard._auxiliary`

* The function `toolbox.set_mouse_position` has been removed and will be moved to a different project in the future
移除了函数 `toolbox.set_mouse_position`，后续会将其移动到其它项目中

🕓 *Release Date / 发布日期 : 2024-10-24*

🟢 **Added / 新增**

* New widget, tooltip (`Tooltip`)
新增控件，工具提示框（`Tooltip`）

* All widgets have a new initialization parameter, `anchor`, to specify the anchor location
所有控件都新增了初始化参数 `anchor` 来指定锚点位置

* New methods `bind`, `unbind`, `bind_on_update` and `unbind_on_update` for all widgets
所有控件新增方法 `bind`、`unbind`、`bind_on_update` 和 `unbind_on_update`

🔵 **Optimized / 优化**

* The function `get_text_size` now can calculate multiple lines of text correctly
函数 `get_text_size` 可以正确计算多行文本了

* The function `get_text_size` added the parameter `master`, which can improve performance when used
函数 `get_text_size` 增加了参数 `master`，当使用该参数时可以提升性能

* Some code outputs an error message in stderr when it causes a problem, rather than no output at all (e.g., when a function in a theme switching thread throws an error)
部分代码产生问题时会在标准错误输出中输出错信息，而不是不产生任何输出（如主题切换线程中的函数引发错误时）

🟣 **Fixed / 修复**

* Fixed a bug where setting the style identity to a class would cause an error
修复了样式标识设置为类会导致错误的 bug

* Fixed a bug where the size would not be calculated correctly when the font was italicized or bold, causing the widget to display incorrectly
修复了字体为斜体或者粗体时，大小不会被正确计算，导致控件显示不正确的 bug

* Fixed a bug that font loading may fail in some cases under Windows
修复 Windows 系统下，部分情况下字体加载可能失败的 bug

* Fixed a bug where the results of the functions `rgb.contrast` and `hsl.contrast` were incorrect
修复了函数 `rgb.contrast` 和 `hsl.contrast` 的结果不正确的 bug

🟡 **Changed / 变更**

* Parameter names for some functions have been changed (the original name violates lint)
部分函数的参数名称发生的改变（原名称违背了 lint）

🔴 **Removed / 移除**

* Removed some of the redundant parameters of the class `Text`
移除了类 `Text` 的部分冗余参数

* Removed unused classes and functions
移除了未使用的类和函数

🕓 *Release Date / 发布日期 : 2024-09-16*

🟢 **Added / 新增**

* Implemented the ability to play videos, see <https://github.com/Xiaokang2022/tkintertools-media>
实现了播放视频的功能，见：<https://github.com/Xiaokang2022/tkintertools-media>

* Added a parameter called `anchor` to `Image`
`Image` 增加了一个名为 `anchor` 的参数

* Added some aliases
增加了一些别名

* Added method `resize` to class `PhotoImage`
类 `PhotoImage` 增加了方法 `resize`

* Added a `callback` parameter to the `set` method of the relevant widget to control whether the callback function is also called when the method is called
相关控件的 `set` 方法增加了参数 `callback` 来控制当该方法被调用时回调函数是否被调用

🟡 **Changed / 变更**

* Changed default value of parameter `anchor` of `Text`
修改了 `Text` 的参数 `anchor` 的默认值

* Changed the API of `SegmentedButton`
修改了 `SegmentedButton` 的 API

🟣 **Fixed / 修复**

* Fixed a bug where widget `SegmentedButton` had incorrect function bindings
修复 `SegmentedButton` 的函数绑定不正确的 bug

* Fixed a bug where disabling styles would not recalculate
修复了禁用样式不会重复计算的 bug

* Fixed a bug where fonts could not be loaded on Linux OS
修复了字体加载函数在 Linux 操作系统上不生效的 bug

* Fixed a bug where the return value of method `alpha` of class `Tk` was incorrect
修复 `Tk` 的方法 `alpha` 的返回值不正确的 bug

* Fixed a bug where some methods of class `Tk` were called and the window style was lost
修复了类 `Tk` 的某些方法被调用时会导致窗口丢失样式的 bug

* Fixed some incorrect type hints and missing parameters
修复了一些不正确的类型提示和丢失的参数

* Fixed a bug where the widget `Image` must be forced to initialize the image parameter, otherwise an error may be reported
修复了控件 `Image` 必须强制指定图片，否则会报错的 bug

🔵 **Optimized / 优化**

* Optimized method `shutdown` of class `Tk`
优化了类 `Tk` 的方法 `shutdown`

* The font loading function has been optimized so that parameter `private` has a certain effect on Linux systems
字体加载函数被优化使得其 `private` 参数能在 Linux 操作系统上产生一定的作用

* Class `MoveTkWidget` has been optimized to prevent it from getting widget data that is not up to date
类 `MoveTkWidget` 被优化以防止其获取到的控件数据不是最新的

* Improved doc string
改善了文档字符串

🔴 **Removed / 移除**

* Removed initialization parameter `transient` of class `Toplevel`
移除了类 `Toplevel` 的初始化参数 `transient`