请求扩展 `canvas.tag_bind` 方法

[Hemerocalle]

Feature Description

我在为控件添加鼠标悬停事件时，发现 tk 原生的 bind 方法被重写了，重写后的 bind 不能正确处理鼠标的 <Enter> 和 <Leave> 事件

测试代码如下

root = maliang.Tk((300, 300))
cv = maliang.Canvas(root)
cv.place(width=300, height=300)

text = maliang.Button(cv, (100, 100), text="Hello, world!")
text.bind("<Enter>", lambda e: print("鼠标进入"))
text.bind("<Leave>", lambda e: print("鼠标离开"))
text.bind("<Motion>", lambda e: print("鼠标移动", end=''))

root.mainloop()

其中 <Enter> 和 <Leave> 事件无法正常执行，而 <Motion> 事件（以及其他 Button 事件）可以正常执行。

在咨询 ai 后得知：对于 canvas 绘制的图形，可以使用 tag_bind 方法控制哪些图形元素响应事件，其函数原型为

tag_bind(self, tagOrId, sequence=None, func=None, add=None)

其中 tagOrId 需要填入 标签名 或 元素ID ，对于 maliang 而言，疑似只能支持 canvas.create_xxx 这类能返回 int 编号的图形，不能支持 virtual.Widget 类控件，因此请求添加相应的支持

Possible Implementation

对于这个问题，解决方案应该还挺多样的，除了扩展 canvas.tag_bind 方法之外，也可以考虑封装一下 TkappType.getint 方法，或者直接让 maliang 的 bind 可以支持 <Enter> 和 <Leave> 事件。当然最好的情况是 maliang 本来就可以实现这个功能只是我操作有问题

Contact Details

2958238716@qq.com

Code of Conduct

• I agree to follow this project's Code of Conduct

[Xiaokang2022]

@Hemerocalle

这是设计上妥协，基本上 maliang 控件的所有事件都是通过在 Canvas 上绑定对应的事件，然后细分到某个控件上再触发对应的关联函数的。比如事件 <Motion>，就是 Canvas 绑定了 <Motion> 事件，然后内部处理这一事件传递的相关信息，当发现鼠标的位置在某个控件的范围内时，就触发在那个位置的控件绑定的关联函数。

但对于事件 <Enter> 和 <Leave>，如果直接绑定到 Canvas 上，那将只在鼠标进入 Canvas 和离开 Canvas 时会触发对应的事件，没办法达到想要的效果。因此对于这两个事件类型，没办法和其它事件类型做一样的处理。目前没有找到比较合适的解决方法。

但并不是说没有办法触发鼠标进入控件的事件。maliang 提供了一种不同于普通事件的绑定，对于所有控件，当控件状态改变时，也可以进行触发。可用简单地认为，控件的状态由 "normal" 变更为 "hover" 时，就是鼠标进入控件的情况了。当然，这不严谨，但在某些情况下是可以暂时代替 <Enter> 事件进行使用的。

具体使用示例：

import maliang

root = maliang.Tk((300, 300))
cv = maliang.Canvas()
cv.place(width=300, height=300)

btn = maliang.Button(cv, (100, 100), text="Hello, world!")


def callback(state: str, gradient_animation: bool) -> None:
    """Callback function."""
    print(f"{state=}, {gradient_animation=}")


btn.bind_on_update(callback)

root.mainloop()

另外，关于你提到的 Canvas.tag_bind 方法，应该是不可行的，我以前尝试过，但这个绑定的事件必须要保证该 item 在画布上可见才能成功触发，但控件并不能保证一直可见，因为 maliang 的控件一般是由很多 item 组成的，有些 item 的某一部分可能并没有颜色，就导致该部分不可见，于是就无法成功触发对应的事件了。对于 TkappType.getint，我没理解这个对于事件绑定有怎样的帮助，你可以仔细解释一下。

当然，如果你有其它更好的实现思路，尽管提出来就是了。