![[Python]表单插件-点击事件](https://media.my7c.com:19000/files/202409/16/01310499-2fa9-49e3-aa16-ad1a81655c3d.jpg)
> **【应用场景】**：定制简单按钮功能，针对特定业务需求。
> **【关键字】**：BarItemClick、AfterBarItemClick
> **【案例演示】**：点击采购订单页面的特定按钮，触发Python按钮插件，显示信息提示。
在金蝶云星空BOS（Business Operation Suite）平台中，我们可以利用Python语言进行表单插件开发，从而实现对特定业务场景的个性化定制。以下是一个基于Python的采购订单按钮插件开发示例，针对的是采购订单单据的按钮插件。
##
## 1. 表单插件按钮点击事件（最先执行）
```python
# 在按钮被点击时触发此事件
def BarItemClick(e):
if e.BarItemKey == "MMK_btn": # 检查按钮键值是否为"MMK_btn"
this.View.ShowMessage("这是BarItemClick按钮测试") # 显示提示信息
```
## 2. 表单插件按钮点击事件（后执行）
```python
# 用于演示在按钮点击事件执行后的处理逻辑
def AfterBarItemClick(e):
if e.BarItemKey == "MMK_btn":
this.View.ShowMessage("这是AfterBarItemClick按钮测试")
```
**描述**：
上述代码片段定义了一个针对采购订单表单的按钮插件。当用户点击键值为"MMK_btn"的按钮时，将会触发 `BarItemClick` 事件，此时会通过 `this.View.ShowMessage` 方法在界面上显示一条提示信息。
如果需要在按钮点击事件执行完毕后进行其他操作，可以启用并自定义 `AfterBarItemClick` 函数，同样检查按钮键值并在满足条件时执行相应的业务逻辑。
请注意，在实际项目中，还需按照金蝶BOS的规范将这些事件处理函数绑定到对应的按钮事件上，确保在按钮被点击时能够正确调用。
## 3.完整代码
```python
# 导入必要的.NET框架库和金蝶BOS相关模块
import clr
clr.AddReference("System")
clr.AddReference("Kingdee.BOS")
clr.AddReference("Kingdee.BOS.Core")
clr.AddReference("Kingdee.BOS.Contracts")
from Kingdee.BOS import *
from Kingdee.BOS.Core import *
from System import *
from System.ComponentModel import *
from System.Collections.Generic import *
from System.Text import *
# 表单插件 - 按钮点击事件处理函数
# 点击按钮:最先执行
def BarItemClick(e):
"""
当用户点击表单中的'MMK_btn'按钮时，此函数会被触发。
参数:
e (BarItemClickEventArgs): 包含按钮信息的事件参数对象
功能描述:
在采购订单界面中，当点击自定义按钮"MMK_btn"时，将在系统界面上显示一条消息。
"""
if e.BarItemKey == "MMK_btn":
this.View.ShowMessage("这是BarItemClick按钮测试")
# # 点击按钮:后执行
# 此部分代码暂未启用，用于演示在按钮点击事件执行后的处理逻辑
# 若要启用，请移除注释符号#
# def AfterBarItemClick(e):
# if e.BarItemKey == "MMK_btn":
# this.View.ShowMessage("这是AfterBarItemClick按钮测试")
```
效果显示
## 4.结尾
以上代码仅为基本示例。在实际开发过程中，应根据具体业务需求进行功能扩展和优化，如数据获取、修改、保存等操作，并确保与金蝶云星空系统无缝集成。
