  
# 介绍
基于PySimpleGUI的一个简单的事件循环库
[PYPI主页地址](https://pypi.org/project/pyguievent/)
# 为什么要用这个库
为啥要搞这玩意,这玩意具体是用来干嘛的？
在GUI开发中肯定会遇到事件以及事件调用的函数,这个在pysimplegui里面使用的并不好,以下是一个例子
~~~python
if event == "btn1":
do_something()
~~~
以上需要写很多冗长的if else 语句，而本库则提供了一种更简单的方法，只需要编写一个函数，然后在这个函数上使用装饰器,就可以实现事件的函数的绑定
~~~python
@app.bind_event('btn1')
def on_do_something():
pass
~~~
## 安装
~~~bash
pip install pyguievent
~~~
## 版本兼容性
python3.4以上,WindowsXP 以上的Windows系统都可以用，其他系统未测试
## 特别说明
事件绑定和事件函数的有点问题，只能接受以下四种形式
1. func()，这种无参数函数
2. func(values=)，这种关键字参数函数，只有一个参数是值
3. func(window=)，这种关键字参数函数，只有一个参数是窗口
4. func(event=)，这种关键字参数函数，只有一个参数是事件
5. 参数有window和event,values,顺序无所谓
6. sg.Window 窗口对象必须要使用finalize=True
7. 强制约束事件函数以 **on_** 开头
## 使用方法
~~~python
import PySimpleGUI as sg
from pyguievent import PySimpleEvent
app = PySimpleEvent()
def make_main_window() -> sg.Window:
task_list = [
sg.Frame(
"Tasks",
[
[sg.Input(key="lot1", tooltip="此输入栏输入即事件触发", enable_events=True)],
[sg.Input(key="lot2", tooltip="此输入框输入后使用回车事件触发")],
[sg.B("win_fun"), sg.B("val_fun")],
[
sg.B("win_val_fun"),
sg.B("no_arg_fun"),
],
[sg.Text("", key="lot3")],
[sg.Text("", key="lot4")],
],
size=(400, 200),
)
]
status_bar = [
sg.StatusBar("版本:"),
sg.StatusBar("状态:"),
]
menu_def = [
["&程序", ["关于", "保存配置", "Exit"]],
["&帮助", "&使用说明..."],
]
top_menu = [sg.Menu(menu_def)]
layout = [top_menu, task_list, status_bar]
# 3.建窗口
return sg.Window(
"测试程式窗口",
layout,
keep_on_top=True,
finalize=True, # 这个属性是必须要的
return_keyboard_events=True, # 如果需要回车事件，这个属性是必须要的
)
@app.bind_event('保存配置')
def on_save_options():
sg.popup("you click save options")
@app.bind_event('lot1')
def on_input_lot1(window: sg.Window, values: dict):
window["lot4"].update(values.get("lot1"))
@app.bind_event('lot2')
def on_enter_lot2(window: sg.Window, values: dict):
new_text = "您输入的是：{}".format(values.get("lot2"))
window["lot3"].update(new_text)
@app.bind_event(["no_arg_fun", "关于"])
def on_no_arg_fun():
sg.popup(
"软件说明：",
"关于事件，点击菜单关于启动",
title="关于程序",
keep_on_top=True,
)
@app.bind_event("win_fun")
def on_win_fun(window: sg.Window):
sg.popup(
"软件说明：",
"新建任务",
title="关于程序",
keep_on_top=True,
)
window["lot2"].set_focus(force=True)
@app.bind_event("val_fun")
def on_val_fun(values: dict):
lot1 = values.get("lot1")
lot2 = values.get("lot2")
sg.popup(
"软件说明：",
"新建任务",
lot1,
lot2,
title="关于程序",
keep_on_top=True,
)
@app.bind_event(["win_val_fun", "lot2"])
def on_win_val_fun(window: sg.Window, values: dict):
sg.popup(
"软件说明：",
"新建任务",
title="关于程序",
keep_on_top=True,
)
lot1 = values.get("lot1")
window["lot3"].update(lot1)
def main():
main_window = make_main_window()
# 增加了一个Exit退出事件
app.run_event(main_window, "Exit")
if __name__ == '__main__':
main()
~~~
Raw data
{
"_id": null,
"home_page": null,
"name": "pyguievent",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": null,
"keywords": "FreeSimpleGUI, GUI, PySimpleEvent, PySimpleGUI, PySimpleGUI4, events for simplegui, pyguievent",
"author": null,
"author_email": "yunluo <sp91@qq.com>",
"download_url": "https://files.pythonhosted.org/packages/da/c5/3adfbd4657e6927e18ffc409fd7872338e02db2e877fab4bb809c67e4492/pyguievent-0.0.9.post0.tar.gz",
"platform": null,
"description": "  \n# \u4ecb\u7ecd\n\u57fa\u4e8ePySimpleGUI\u7684\u4e00\u4e2a\u7b80\u5355\u7684\u4e8b\u4ef6\u5faa\u73af\u5e93\n\n[PYPI\u4e3b\u9875\u5730\u5740](https://pypi.org/project/pyguievent/)\n# \u4e3a\u4ec0\u4e48\u8981\u7528\u8fd9\u4e2a\u5e93\n\u4e3a\u5565\u8981\u641e\u8fd9\u73a9\u610f,\u8fd9\u73a9\u610f\u5177\u4f53\u662f\u7528\u6765\u5e72\u561b\u7684\uff1f\n\u5728GUI\u5f00\u53d1\u4e2d\u80af\u5b9a\u4f1a\u9047\u5230\u4e8b\u4ef6\u4ee5\u53ca\u4e8b\u4ef6\u8c03\u7528\u7684\u51fd\u6570,\u8fd9\u4e2a\u5728pysimplegui\u91cc\u9762\u4f7f\u7528\u7684\u5e76\u4e0d\u597d,\u4ee5\u4e0b\u662f\u4e00\u4e2a\u4f8b\u5b50\n~~~python\nif event == \"btn1\":\n do_something()\n~~~\n\u4ee5\u4e0a\u9700\u8981\u5199\u5f88\u591a\u5197\u957f\u7684if else \u8bed\u53e5\uff0c\u800c\u672c\u5e93\u5219\u63d0\u4f9b\u4e86\u4e00\u79cd\u66f4\u7b80\u5355\u7684\u65b9\u6cd5\uff0c\u53ea\u9700\u8981\u7f16\u5199\u4e00\u4e2a\u51fd\u6570\uff0c\u7136\u540e\u5728\u8fd9\u4e2a\u51fd\u6570\u4e0a\u4f7f\u7528\u88c5\u9970\u5668,\u5c31\u53ef\u4ee5\u5b9e\u73b0\u4e8b\u4ef6\u7684\u51fd\u6570\u7684\u7ed1\u5b9a\n\n~~~python\n@app.bind_event('btn1')\ndef on_do_something():\n pass\n~~~\n\n## \u5b89\u88c5\n~~~bash\npip install pyguievent\n~~~\n\n## \u7248\u672c\u517c\u5bb9\u6027\npython3.4\u4ee5\u4e0a,WindowsXP \u4ee5\u4e0a\u7684Windows\u7cfb\u7edf\u90fd\u53ef\u4ee5\u7528\uff0c\u5176\u4ed6\u7cfb\u7edf\u672a\u6d4b\u8bd5\n\n## \u7279\u522b\u8bf4\u660e\n\u4e8b\u4ef6\u7ed1\u5b9a\u548c\u4e8b\u4ef6\u51fd\u6570\u7684\u6709\u70b9\u95ee\u9898\uff0c\u53ea\u80fd\u63a5\u53d7\u4ee5\u4e0b\u56db\u79cd\u5f62\u5f0f\n1. func()\uff0c\u8fd9\u79cd\u65e0\u53c2\u6570\u51fd\u6570\n2. func(values=)\uff0c\u8fd9\u79cd\u5173\u952e\u5b57\u53c2\u6570\u51fd\u6570\uff0c\u53ea\u6709\u4e00\u4e2a\u53c2\u6570\u662f\u503c\n3. func(window=)\uff0c\u8fd9\u79cd\u5173\u952e\u5b57\u53c2\u6570\u51fd\u6570\uff0c\u53ea\u6709\u4e00\u4e2a\u53c2\u6570\u662f\u7a97\u53e3\n4. func(event=)\uff0c\u8fd9\u79cd\u5173\u952e\u5b57\u53c2\u6570\u51fd\u6570\uff0c\u53ea\u6709\u4e00\u4e2a\u53c2\u6570\u662f\u4e8b\u4ef6\n5. \u53c2\u6570\u6709window\u548cevent,values,\u987a\u5e8f\u65e0\u6240\u8c13\n6. sg.Window \u7a97\u53e3\u5bf9\u8c61\u5fc5\u987b\u8981\u4f7f\u7528finalize=True\n7. \u5f3a\u5236\u7ea6\u675f\u4e8b\u4ef6\u51fd\u6570\u4ee5 **on_** \u5f00\u5934\n\n\n## \u4f7f\u7528\u65b9\u6cd5\n\n~~~python\nimport PySimpleGUI as sg\nfrom pyguievent import PySimpleEvent\n\napp = PySimpleEvent()\n\n\ndef make_main_window() -> sg.Window:\n task_list = [\n sg.Frame(\n \"Tasks\",\n [\n [sg.Input(key=\"lot1\", tooltip=\"\u6b64\u8f93\u5165\u680f\u8f93\u5165\u5373\u4e8b\u4ef6\u89e6\u53d1\", enable_events=True)],\n [sg.Input(key=\"lot2\", tooltip=\"\u6b64\u8f93\u5165\u6846\u8f93\u5165\u540e\u4f7f\u7528\u56de\u8f66\u4e8b\u4ef6\u89e6\u53d1\")],\n [sg.B(\"win_fun\"), sg.B(\"val_fun\")],\n [\n sg.B(\"win_val_fun\"),\n sg.B(\"no_arg_fun\"),\n ],\n [sg.Text(\"\", key=\"lot3\")],\n [sg.Text(\"\", key=\"lot4\")],\n ],\n size=(400, 200),\n )\n ]\n\n status_bar = [\n sg.StatusBar(\"\u7248\u672c:\"),\n sg.StatusBar(\"\u72b6\u6001:\"),\n ]\n\n menu_def = [\n [\"&\u7a0b\u5e8f\", [\"\u5173\u4e8e\", \"\u4fdd\u5b58\u914d\u7f6e\", \"Exit\"]],\n [\"&\u5e2e\u52a9\", \"&\u4f7f\u7528\u8bf4\u660e...\"],\n ]\n\n top_menu = [sg.Menu(menu_def)]\n\n layout = [top_menu, task_list, status_bar]\n\n # 3.\u5efa\u7a97\u53e3\n return sg.Window(\n \"\u6d4b\u8bd5\u7a0b\u5f0f\u7a97\u53e3\",\n layout,\n keep_on_top=True,\n finalize=True, # \u8fd9\u4e2a\u5c5e\u6027\u662f\u5fc5\u987b\u8981\u7684\n return_keyboard_events=True, # \u5982\u679c\u9700\u8981\u56de\u8f66\u4e8b\u4ef6\uff0c\u8fd9\u4e2a\u5c5e\u6027\u662f\u5fc5\u987b\u8981\u7684\n )\n\n\n@app.bind_event('\u4fdd\u5b58\u914d\u7f6e')\ndef on_save_options():\n sg.popup(\"you click save options\")\n\n\n@app.bind_event('lot1')\ndef on_input_lot1(window: sg.Window, values: dict):\n window[\"lot4\"].update(values.get(\"lot1\"))\n\n\n@app.bind_event('lot2')\ndef on_enter_lot2(window: sg.Window, values: dict):\n new_text = \"\u60a8\u8f93\u5165\u7684\u662f\uff1a{}\".format(values.get(\"lot2\"))\n window[\"lot3\"].update(new_text)\n\n\n@app.bind_event([\"no_arg_fun\", \"\u5173\u4e8e\"])\ndef on_no_arg_fun():\n sg.popup(\n \"\u8f6f\u4ef6\u8bf4\u660e\uff1a\",\n \"\u5173\u4e8e\u4e8b\u4ef6\uff0c\u70b9\u51fb\u83dc\u5355\u5173\u4e8e\u542f\u52a8\",\n title=\"\u5173\u4e8e\u7a0b\u5e8f\",\n keep_on_top=True,\n )\n\n\n@app.bind_event(\"win_fun\")\ndef on_win_fun(window: sg.Window):\n sg.popup(\n \"\u8f6f\u4ef6\u8bf4\u660e\uff1a\",\n \"\u65b0\u5efa\u4efb\u52a1\",\n title=\"\u5173\u4e8e\u7a0b\u5e8f\",\n keep_on_top=True,\n )\n window[\"lot2\"].set_focus(force=True)\n\n\n@app.bind_event(\"val_fun\")\ndef on_val_fun(values: dict):\n lot1 = values.get(\"lot1\")\n lot2 = values.get(\"lot2\")\n sg.popup(\n \"\u8f6f\u4ef6\u8bf4\u660e\uff1a\",\n \"\u65b0\u5efa\u4efb\u52a1\",\n lot1,\n lot2,\n title=\"\u5173\u4e8e\u7a0b\u5e8f\",\n keep_on_top=True,\n )\n\n\n@app.bind_event([\"win_val_fun\", \"lot2\"])\ndef on_win_val_fun(window: sg.Window, values: dict):\n sg.popup(\n \"\u8f6f\u4ef6\u8bf4\u660e\uff1a\",\n \"\u65b0\u5efa\u4efb\u52a1\",\n title=\"\u5173\u4e8e\u7a0b\u5e8f\",\n keep_on_top=True,\n )\n lot1 = values.get(\"lot1\")\n window[\"lot3\"].update(lot1)\n\n\ndef main():\n main_window = make_main_window()\n\n # \u589e\u52a0\u4e86\u4e00\u4e2aExit\u9000\u51fa\u4e8b\u4ef6\n app.run_event(main_window, \"Exit\")\n\n\nif __name__ == '__main__':\n main()\n\n~~~\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "A simple tool to create events to PySimpleGUI or PySimpleGUI4",
"version": "0.0.9.post0",
"project_urls": {
"Homepage": "https://github.com/yunluo/pyguievent",
"Repository": "https://github.com/yunluo/pyguievent"
},
"split_keywords": [
"freesimplegui",
" gui",
" pysimpleevent",
" pysimplegui",
" pysimplegui4",
" events for simplegui",
" pyguievent"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "f2c5c185ed3fa21002ddaa9ad2cfe2cead4f8144fb9dc3b0eca6a044c009bc63",
"md5": "ab7f301da38101121d92f8606378fbb1",
"sha256": "bd6b922d92e14ca0ec4949fbfe7e2559b22b93851f4c9204f55bd196d5da2c78"
},
"downloads": -1,
"filename": "pyguievent-0.0.9.post0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ab7f301da38101121d92f8606378fbb1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 18175,
"upload_time": "2025-09-14T02:30:48",
"upload_time_iso_8601": "2025-09-14T02:30:48.565288Z",
"url": "https://files.pythonhosted.org/packages/f2/c5/c185ed3fa21002ddaa9ad2cfe2cead4f8144fb9dc3b0eca6a044c009bc63/pyguievent-0.0.9.post0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dac53adfbd4657e6927e18ffc409fd7872338e02db2e877fab4bb809c67e4492",
"md5": "259577cfffeaed10e6a5081304d54e9e",
"sha256": "cd8887d59450e08b0e471c2ee4a65eef776c81f097ec83f82f9b3a3d7c092077"
},
"downloads": -1,
"filename": "pyguievent-0.0.9.post0.tar.gz",
"has_sig": false,
"md5_digest": "259577cfffeaed10e6a5081304d54e9e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 20786,
"upload_time": "2025-09-14T02:30:49",
"upload_time_iso_8601": "2025-09-14T02:30:49.868034Z",
"url": "https://files.pythonhosted.org/packages/da/c5/3adfbd4657e6927e18ffc409fd7872338e02db2e877fab4bb809c67e4492/pyguievent-0.0.9.post0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-14 02:30:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yunluo",
"github_project": "pyguievent",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pyguievent"
}
JSON
