Metadata-Version: 2.4
Name: TkinterTabMore
Version: 0.0.1
Summary: 为 tkinter 提供常用字符串常量和增强功能
Home-page: https://github.com/ 你的用户名/TkinterTabMore
Author: dideng
Author-email: 3483434955@qq.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# 🧩 TkinterTabMore —— 为 Tkinter 提供常用常量和更多功能

## ✨ 简介 / Introduction

`TkinterTabMore` 是一个为 Python 的 `tkinter` 模块提供常用字符串常量和增强功能的辅助模块，旨在提升开发效率并减少拼写错误。

`TkinterTabMore` is a helper module that provides commonly used string constants and enhanced features for the Python `tkinter` module, aiming to improve development efficiency and reduce typos.

---

## 📦 安装 / Installation

```bash
pip install TkinterTabMore
```

## 📚 使用示例 / Usage Example
```
from tkinter import *
from TkinterTabMore import WM_DELETE_WINDOW, CURSOR_HAND, RELIEF_RAISED

root = Tk()
root.protocol(WM_DELETE_WINDOW, root.destroy)

btn = Button(root, text="点击 / Click", cursor=CURSOR_HAND, relief=RELIEF_RAISED)
btn.pack()

root.mainloop()
```


---

### 📄 第 2 段：窗口管理器协议 + 拖放支持（Xdnd）

---

## 📋 支持的常量列表 / Supported Constants

### 1. 🔧 窗口管理器协议 / Window Manager Protocols

- `WM_DELETE_WINDOW = "WM_DELETE_WINDOW"`  
  窗口关闭协议 / Window close protocol
- `WM_PROTOCOL_MESSAGE = "WM_PROTOCOL_MESSAGE"`  
  窗口管理器通信消息 / Window manager communication message

---

### 2. 🖱️ 拖放支持（Xdnd） / Drag and Drop (Xdnd)

- `XdndEnter = "XdndEnter"`  
  拖放进入窗口事件 / Drag enters the window
- `XdndPosition = "XdndPosition"`  
  拖放位置更新事件 / Drag position update event
- `XdndDrop = "XdndDrop"`  
  拖放释放事件 / Drop event
- `XdndStatus = "XdndStatus"`  
  拖放状态反馈事件 / Drag status feedback event
- `XdndLeave = "XdndLeave"`  
  拖放离开窗口事件 / Drag leaves the window
- `XdndFinished = "XdndFinished"`  
  拖放结束事件 / Drag finished event
- `XdndSelection = "XdndSelection"`  
  拖放数据请求事件 / Drag data request event
- `XdndActionCopy = "XdndActionCopy"`  
  拖放复制操作 / Copy action in drag and drop
- `XdndActionMove = "XdndActionMove"`  
  拖放移动操作 / Move action in drag and drop
- `XdndActionLink = "XdndActionLink"`  
  拖放链接操作 / Link action in drag and drop
- `XdndActionAsk = "XdndActionAsk"`  
  拖放询问用户操作 / Ask user action in drag and drop

---

### 3. 📋 剪贴板 / Clipboard

- `CLIPBOARD = "CLIPBOARD"`  
  系统剪贴板名称 / System clipboard name
- `PRIMARY = "PRIMARY"`  
  主选剪贴板名称（X11） / Primary selection clipboard (X11)
- `TARGETS = "TARGETS"`  
  剪贴板数据类型列表 / Clipboard data type list

---

### 4. 🎯 虚拟事件 / Virtual Events

- `VIRTUAL_EVENT_PREFIX = "<<"`  
  虚拟事件前缀 / Prefix for virtual events
- `VIRTUAL_EVENT_SUFFIX = ">>"`  
  虚拟事件后缀 / Suffix for virtual events

---

### 5. 📦 Tk 版本 / Tk Versions

- `TK_VERSION = "tk_version"`  
  Tk 当前版本号字符串 / Current Tk version string
- `TK_PATCHLEVEL = "tk_patchLevel"`  
  Tk 补丁级别 / Tk patch level

---

### 6. 📁 文件类型 / File Types

- `FILE_TYPES_ALL = "*.*"`  
  所有文件类型 / All file types
- `FILE_TYPES_TEXT = "*.txt"`  
  文本文件 / Text file type (*.txt)
- `FILE_TYPES_PYTHON = "*.py"`  
  Python 源代码文件 / Python source files (*.py)
- `FILE_TYPES_IMAGE = "*.png *.jpg *.jpeg *.gif *.bmp"`  
  图像文件 / Image files (*.png, *.jpg, etc.)
- `FILE_TYPES_JSON = "*.json"`  
  JSON 数据文件 / JSON data files (*.json)
- `FILE_TYPES_CSV = "*.csv"`  
  CSV 表格文件 / CSV table files (*.csv)

---

### 7. 🖱️ 鼠标光标 / Mouse Cursors

- `CURSOR_ARROW = "arrow"`  
  箭头光标 / Arrow cursor
- `CURSOR_HAND = "hand2"`  
  手型光标 / Hand cursor
- `CURSOR_XTERM = "xterm"`  
  文本输入光标 / Text input cursor
- `CURSOR_CROSSHAIR = "crosshair"`  
  十字光标 / Crosshair cursor
- `CURSOR_WAIT = "watch"`  
  等待光标 / Wait cursor
- `CURSOR_SIZE_NW_SE = "size_nw_se"`  
  西北-东南调整光标 / NW-SE resize cursor
- `CURSOR_SIZE_NE_SW = "size_ne_sw"`  
  东北-西南调整光标 / NE-SW resize cursor
- `CURSOR_SIZE_HOR = "sb_h_double_arrow"`  
  水平调整光标 / Horizontal resize cursor
- `CURSOR_SIZE_VER = "sb_v_double_arrow"`  
  垂直调整光标 / Vertical resize cursor

---

### 8. ⚙️ 控件状态 / Widget States

- `STATE_NORMAL = "normal"`  
  控件可用状态 / Widget is enabled and interactive
- `STATE_DISABLED = "disabled"`  
  控件禁用状态 / Widget is disabled
- `STATE_READONLY = "readonly"`  
  控件只读状态 / Widget is read-only

---

### 9. 🧭 锚点位置 / Anchor Positions

- `ANCHOR_CENTER = "center"`  
  居中对齐 / Center alignment
- `ANCHOR_N = "n"`  
  北对齐（上） / North (top) alignment
- `ANCHOR_S = "s"`  
  南对齐（下） / South (bottom) alignment
- `ANCHOR_E = "e"`  
  东对齐（右） / East (right) alignment
- `ANCHOR_W = "w"`  
  西对齐（左） / West (left) alignment
- `ANCHOR_NE = "ne"`  
  东北对齐 / Northeast alignment
- `ANCHOR_NW = "nw"`  
  西北对齐 / Northwest alignment
- `ANCHOR_SE = "se"`  
  东南对齐 / Southeast alignment
- `ANCHOR_SW = "sw"`  
  西南对齐 / Southwest alignment

---

### 10. 📐 布局扩展 / Layout Expand Options

- `EXPAND_BOTH = "both"`  
  同时扩展 / Expand both horizontally and vertically
- `EXPAND_X = "x"`  
  横向扩展 / Expand horizontally
- `EXPAND_Y = "y"`  
  纵向扩展 / Expand vertically

---

### 11. 📦 填充方向 / Fill Options

- `FILL_X = "x"`  
  横向填充 / Fill horizontally
- `FILL_Y = "y"`  
  纵向填充 / Fill vertically
- `FILL_BOTH = "both"`  
  横纵填充 / Fill both directions
- `FILL_NONE = "none"`  
  不填充 / No fill

---

### 12. 🧱 排列方向 / Layout Side Options

- `SIDE_TOP = "top"`  
  顶部排列 / Pack to the top
- `SIDE_BOTTOM = "bottom"`  
  底部排列 / Pack to the bottom
- `SIDE_LEFT = "left"`  
  左侧排列 / Pack to the left
- `SIDE_RIGHT = "right"`  
  右侧排列 / Pack to the right

---

### 13. 📐 对齐方式 / Justify Options

- `JUSTIFY_LEFT = "left"`  
  左对齐 / Left justify
- `JUSTIFY_CENTER = "center"`  
  居中对齐 / Center justify
- `JUSTIFY_RIGHT = "right"`  
  右对齐 / Right justify

---

### 14. 🧱 边框样式 / Relief Styles

- `RELIEF_RAISED = "raised"`  
  凸起边框样式 / Raised relief style
- `RELIEF_SUNKEN = "sunken"`  
  凹陷边框样式 / Sunken relief style
- `RELIEF_FLAT = "flat"`  
  平直边框样式 / Flat relief style
- `RELIEF_GROOVE = "groove"`  
  沟槽边框样式 / Groove relief style
- `RELIEF_RIDGE = "ridge"`  
  山脊边框样式 / Ridge relief style
- `RELIEF_SOLID = "solid"`  
  实线边框样式 / Solid relief style

---

### 15. 🔤 其他常用值 / Other Useful Constants

- `YES = "yes"`  
  Tkinter 中的“是”值 / 'yes' in layout options
- `NO = "no"`  
  Tkinter 中的“否”值 / 'no' in layout options
- `TRUE = "1"`  
  Tkinter 中的“真”值 / '1' as True
- `FALSE = "0"`  
  Tkinter 中的“假”值 / '0' as False
- `DEFAULT = "default"`  
  Tkinter 中默认选项 / Default option

---


## 🙌 感谢使用 / Thanks for Using

感谢你使用 `TkinterTabMore`！如果你有任何建议或问题，欢迎提交 issue 或 PR。  
Thanks for using `TkinterTabMore`! If you have any suggestions or issues, feel free to open an issue or pull request.
