🔖 3.0.0.beta4

🟢 Added / 新增

• The widget Entry has a new parameter placeholder to display the prompt information
  小部件 Entry 新增了参数 placeholder 来实现提示信息的显示

• Added parameter show to the widget Entry to mask characters (e.g. password box)
  小部件 Entry 新增了参数 show 来实现字符的掩盖（如密码框）

• The new parameter align has been added to the widget Entry to achieve a similar effect to the text-align of tags in HTML, i.e. the left, right, and center layout of the text
  小部件 Entry 新增了参数 align 来实现于 HTML 里的标签的 text-align 类似的效果，即文本的靠左、靠右和居中布局

• The widget Entry has been added to move the text prompt by pressing the left and right keys on the keyboard
  小部件 Entry 新增了通过按下键盘的左右键来移动文本提示符的功能

• Added text selection to the widget Entry
  小部件 Entry 新增了文本选中的功能

• The widget Entry has added shortcuts to copy (Ctrl+C), paste (Ctrl+V) and cut (Ctrl+X)
  小部件 Entry 新增了快捷键复制（Ctrl+C）、粘贴（Ctrl+V）和剪切（Ctrl+X）的功能

• Added widget slider (Slider)
  新增了小部件滑动条（Slider）

• Added widget icon button (IconButton)
  新增了小部件图标按钮（IconButton）

• Added some missing docstrings
  增加了部分缺失的文档字符串

🟡 Changed / 变更

• The color of the widget Entry has been changed slightly under Windows 10 to enhance the look
  小部件 Entry 在 Windows 10 操作系统下的颜色略有改变，以提升观感

• The position of the text of the widget Entry in the text box has been slightly corrected to improve the look
  小部件 Entry 的文本在文本框中的位置被稍微修正了一下，以提升观感

🟣 Fixed / 修复

• Fixed a bug where deleting text from the widget Entry in some cases would cause the program to loop in an endless loop
  修复了小部件 Entry 某些情况下删除文本会导致程序死循环的问题

🔵 Optimized / 优化

• Improved the readability of some codes
  增强了部分代码的可读性

🔴 Removed / 移除

• Widget Entry removed the parameters justify and anchor
  小部件 Entry 移除了参数 justify 和 anchor

• Removed the 3D part of the code and related theme files
  移除了 3D 部分代码以及相关主题文件

Thank you for your support of this project! ❤️
感谢各位对本项目的支持！❤️

🔖 3.0.0.beta3

🟢 Added / 新增

• The docstrings for a portion of the code has been added
  添加了一部分代码的文本字符串

• animation.animations has added class MoveTkWidget to move a tkinter widget
  animation.animations 新增类 MoveTkWidget 来移动一个 tkinter 小部件

• core.containers.Canvas added the parameter name to bind the theme
  core.containers.Canvas 新增参数 name 来绑定主题

• core.containers.Canvas added method _zoom_children to scale the tkinter widget of the Place layout
  core.containers.Canvas 新增方法 _zoom_children 来实现对 Place 布局的 tkinter 小部件的缩放

• Introduce the optional third-party package pillow and add a new class PhotoImage in toolbox.enhanced to improve image scaling performance
  引入可选的第三方包 pillow 并在 toolbox.enhanced 新增类 PhotoImage 以提高图片缩放的性能

• Introduce an optional third-party package matplotlib and add a new module mpl to toolbox to achieve compatibility with matplotlib related interfaces
  引入可选的第三方包 matplotlib 并在 toolbox 中新增模块 mpl 来实现对 matplotlib 相关接口的兼容

• toolbox.tools adds the function get_hwnd to fetch the HWND of the widget
  toolbox.tools 新增函数 get_hwnd 来实现小部件的 HWND 的获取

• toolbox.tools adds a new function embed_window to embed a widget into another widget, which only works on Windows
  toolbox.tools 新增函数 embed_window 来将一个小部件嵌入到另外一个小部件中，仅在 Windows 系统中有效

• toolbox.tools adds a new function screen_size to get the width and height of the screen
  toolbox.tools 新增函数 screen_size 来获取屏幕的宽度和高度

• toolbox.tools adds a new function set_mouse_position to set the mouse position, which only works on Windows
  toolbox.tools 新增函数 set_mouse_position 来设置鼠标的位置，仅在 Windows 系统中有效

• toolbox.tools adds a new function _forward_methods to implement the forwarding of class methods
  toolbox.tools 新增函数 _forward_methods 来实现类方法的转发

• Introduce optional third-party packages pywinstyles, win32material and hPyT, and add many new parameters to style.manager.customize_window to implement the corresponding interfaces
  引入可选的第三方包 pywinstyles、win32material 和 hPyT 并在 style.manager.customize_window 新增许多参数来实现对应的接口

🔴 Removed / 移除

• Remove function color.rgb._str_to_hex, this function is useless
  移除函数 color.rgb._str_to_hex，此函数无用

• Remove class core.containers.Dialog, this class is useless
  移除类 core.containers.Dialog，此类无用

• Removed the class core.containers.ChildWindow and there is a better way to replace it
  移除类 core.containers.ChildWindow，已有其它更好的替换方式

• Remove redundant code from three.engine in preparation for the next refactoring
  移除 three.engine 中的冗余代码，为下个版本重构做准备

🟡 Changed / 变更

• animation.animations.Gradient renamed to GradientItem
animation.animations.Gradient 更名为 GradientItem

• The value of core.constants.SIZE has been changed from -24 to -20 (a value close to the system text size)
  core.constants.SIZE 的值从 -24 更改为 -20（与系统文本大小接近的值）

• The default size of most widgets has been reduced to accommodate the font size change
  大部分小部件的默认大小缩小了，以配合字体大小的变更

• style.theme is renamed to manager to avoid having the same name as the theme folder
  style.theme 更名为 manager，避免跟主题文件夹 theme 重名

• The rules for storing theme files have been completely changed, as shown in the module docstring for style.parser
  主题文件存放规则完全更改，具体见 style.parser 的模块文档字符串

• style.theme.custom_window renamed to style.manager.customize_window
style.theme.custom_window 更名为 style.manager.customize_window

• three.engine.Side renamed to three.engine.Plane
three.engine.Side 更名为 three.engine.Plane

🔵 Optimized / 优化

• Now the third-party package darkdetect is no longer required, but optional. When this package is missing, some features will be unavailable
  现在第三方包 darkdetect 不是必需的了，而是可选的。当缺少此包，将导致部分功能不可用

🟣 Fixed / 修复

• Fixed some incorrect docstrings
  修正了部分错误的文档字符串

• Fixed an issue where the subject response event was not removed when the window was closed
  修复了窗口关闭时未删去主题响应事件的问题

• Fixed an issue where the widget style did not change completely in some cases when the widget was disabled
  修复了小部件禁用时，部分情况下小部件样式未完全更改的问题

🟤 Refactored / 重构

• core.virtual refactoring to remove redundant code and optimize existing code
  core.virtual 重构，删去冗余代码，优化已有代码

• style refactored
  style 重构

Thank you for your support of this project! ❤️
感谢各位对本项目的支持！❤️

🔖 3.0.0.beta2

🟢 Added / 新增

• The docstrings for a portion of the code has been added
  添加了一部分代码的文本字符串

• Modules have added a special variable __all__
  模块都增加了特殊变量 __all__

• Subpackage color Added module hsl to support HSL color coding
  子包 color 新增模块 hsl 以支持 HSL 颜色码

• The submodule constants adds the function reset to reset all constants to default
  子模块 constants 新增函数 reset 来重置所有常量为默认值

• The submodule theme of the sub-package style has added the function set_color_theme to use the external theme
  子包 style 的子模块 theme 新增函数 set_color_theme 来使用外部主题

• Added subpackage toolbox and function load_font to introduce external font files
  新增子包 toolbox 以及函数 load_font 来引入外部字体文件

• Submodule enhanced of sub-package toolbox adds class PhotoImage
  子包 toolbox 的子模块 enhanced 新增类 PhotoImage

• The submodule tools class _Trigger has been further enhanced by the addition of methods lock and unlock and related properties
  子模块 tools 的类 _Trigger 新增方法 lock 和 unlock 以及相关属性，来进一步增强它的功能

• The submodule images has added a class StillImage to support png type static images
  子模块 images 新增类 StillImage 来支持 png 类型的静态图片

• Virtual Picture Base Class virtual.Image implements the relevant methods
  虚拟图片基类 virtual.Image 实现了相关方法

• The virtual widget base class virtual.Widget added new methods appear and disappear to hide and reproduce the widget as a whole
  虚拟小部件基类 virtual.Widget 新增了方法 appear 和 disappear 来实现小部件整体的隐藏和再现

🟡 Changed / 变更

• The classes Message, ColorChooser, and FontChooser of the submodule dialogs have been renamed TkMessage, TkColorChooser, and TkFontChooser, respectively
  子模块 dialogs 的类 Message、ColorChooser 和 FontChooser 分别更名为 TkMessage、TkColorChooser 和 TkFontChooser

• The function tkintertools.style.theme.use_theme is renamed to set_color_mode
  函数 tkintertools.style.theme.use_theme 更名为 set_color_mode

• The rotation event of the class Space of the subpack three has been changed from the original left-mouse button to the middle mouse button
  子包 three 的类 Space 的旋转事件由原来的鼠标左键触发更改为鼠标中键触发

🔵 Optimized / 优化

• Optimized the implementation of the function custom_window of the submodule theme to prevent it from taking effect in some cases
  优化了子模块 theme 的函数 custom_window 的实现方式，防止某些情况下无法生效

• All container widgets have been optimized to prevent the functionality from working under certain conditions
  所有容器小部件都得到了优化，防止某些条件下会出现相关功能未生效的情况

• All virtual widgets are perfected with initialization parameters
  所有虚拟小部件都完善了初始化参数

🟤 Refactored / 重构

• Core code refactoring, from module core.py to sub-package core
  核心代码重构，由模块 core.py 重构为子包 core

• Subpackage three refactoring
  子包 three 重构

Thank you for your support of this project! ❤️
感谢各位对本项目的支持！❤️

🔖 3.0.0.beta1

After 8 months of refactoring work (10 dev releases, 7 alpha releases, 1 beta release), TkinterTools has made the leap from Gen 2 to Gen 3 🚀! But tkintertools 3 is still in a beta state, and I don't recommend using it directly in a production environment, as it currently has some issues to be resolved, and the API may not be fully determined.
经过 8 个月的重构工作（10 个 dev 版本，7 个 alpha 版本，1 个 beta 版本），tkintertools 已经从第 2 代版本跃升至第 3 代了 🚀！但 tkintertools 3 仍处于一个测试状态，我不推荐你直接再生产环境中使用它，因为它目前存在一些问题有待解决，而且 API 可能也没有完全确定。

In conclusion, tkintertools 3 has entered the public beta state 🎉! You can install it with the following command:
总之，tkintertools 3 进入了 beta 版本的公开测试状态 🎉！你可以通过下面的命令来安装它：

pip install tkintertools==3.0.0b1

But no matter what, I would like to thank everyone for their support of this project ❤️! I hope that there will be more and more ⭐ in this project!
但无论如何，我都要感谢大家对本项目的支持 ❤️ ！希望本项目的 ⭐ 可以越来越多吧！

✨ What 's New - 更新内容

Note

Due to the large number of updates, I won't release it here, you can go to the changelog on the official website of tkintertools to view!
由于更新内容较多，这里就不放出来了，大家可以去 tkintertools 官网更新日志进行查看！

👀 Preview - 预览

The following preview pictures are all the effects produced by the same Demo, there are many Demo codes, and they are not shown here, you can go to the official website of tkintertools Update Notes to view.
下面的预览图都是同一个 Demo 产生的效果，Demo 代码较多，这里同样不展示，大家可自行去 tkintertools 官网更新说明处查看。

Unfortunately, there is no documentation available for your reference.
不过有件事很遗憾，就是目前并没有可用的文档供大家参考。

👁️ Click to view - 点击查看

Windows11

Windows10

macOS

WSL

Kubuntu

---

Thank you to my friends who helped me test on other platforms!
感谢帮助我对其它平台测试的朋友们！