Guides
表单工具栏
表单模式下，底部会显示表单工具栏（CFormToolbar），用于创建和编辑各类表单控件。通过 FormsConfig 可配置可用的表单类型、工具按钮及行为开关。
可用表单类型
availableTypes 控制表单工具栏中显示的表单类型按钮：
json
{
"formsConfig": {
"availableTypes": [
"textField",
"checkBox",
"radioButton",
"listBox",
"comboBox",
"signaturesFields",
"pushButton"
]
}
}1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
| 值 | 说明 |
|---|---|
textField | 文本输入框 |
checkBox | 复选框 |
radioButton | 单选按钮 |
listBox | 列表框 |
comboBox | 下拉框 |
signaturesFields | 签名域 |
pushButton | 按钮 |
可用工具
json
{
"formsConfig": {
"availableTools": [
"undo",
"redo"
]
}
}1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
| 值 | 说明 |
|---|---|
undo | 撤销 |
redo | 重做 |
行为开关
创建选项对话框
控制创建特定表单控件后是否自动弹出属性设置对话框（仅 ListBox、ComboBox 和 PushButton 支持）：
json
{
"formsConfig": {
"showCreateListBoxOptionsDialog": true,
"showCreateComboBoxOptionsDialog": true,
"showCreatePushButtonOptionsDialog": true
}
}1
2
3
4
5
6
7
2
3
4
5
6
7
| 字段 | 说明 |
|---|---|
showCreateListBoxOptionsDialog | 创建列表框后弹出属性对话框 |
showCreateComboBoxOptionsDialog | 创建下拉框后弹出属性对话框 |
showCreatePushButtonOptionsDialog | 创建按钮后弹出属性对话框 |
拦截操作
可拦截默认的表单交互行为，通过事件回调自定义处理（仅 ListBox、ComboBox 和 PushButton 支持）：
json
{
"formsConfig": {
"interceptListBoxAction": false,
"interceptComboBoxAction": false,
"interceptPushButtonAction": false
}
}1
2
3
4
5
6
7
2
3
4
5
6
7
| 字段 | 说明 |
|---|---|
interceptListBoxAction | 拦截列表框点击 |
interceptComboBoxAction | 拦截下拉框点击 |
interceptPushButtonAction | 拦截按钮点击 |
设为 true 后，点击对应表单控件不再执行默认行为，而是触发 CPDFCustomEventCallbackHelper 回调，你可以在回调中实现自定义逻辑。
CFormToolbar 组件
CFormToolbar 是表单工具栏的核心 UI 组件，位于 com.compdfkit.tools.forms.pdfformbar 包中。
相关类：
| 类 | 说明 |
|---|---|
CFormToolbar | 表单工具栏主视图 |
CFormToolbarAdapter | 表单类型列表适配器 |
CFormToolBean | 表单工具项数据模型 |