OneNote插件 Onetastic插件对话框函数小结模板分享

OneNote教程 2023-05-30 19:32:39

Onetastic中提供的函数并不多，真正重要的其实只有以下四类：数组、对话框、对象、字符串。通过这四个类别，基本上可以满足日常需求了。

本文重点介绍对话框函数（DialogBoxFunctions）。

对话框为用户提供了一个可视化的交互界面，使用对话框，可以让脚本的功能变得更加全面，用起来也更加方便。

DialogBox函数大类中提供了7个相关函数，分别是：DialogBox_AddCheckBox、DialogBox_AddColorPicker、DialogBox_AddDropDown、DialogBox_AddLabel、DialogBox_AddTextBox、DialogBox_Create、DialogBox_Show。其中，DialogBox_AddColorPicker是后期新加入的函数，另外6个从初期开始就一直存在，相当典型、重要。下面简要介绍每个函数的基本用法。

1.DialogBox函数介绍

DialogBox_AddCheckBox，复选框，勾选代表true，不勾选代表false。

DialogBox_AddColorPicker，颜色选择器，后期新增函数，不常用。

DialogBox_AddDropDown，下拉列表，分类处理。

DialogBox_AddLabel，文字标签，可以在将说明或备注文字添加到对话框上。

DialogBox_AddTextBox，文本框，多用于输入自定义参数。

以上5个函数是具体的控件函数，这些控件都可以直接添加到对话框的界面中，并且都会添加到DialogBox对象中的controls属性中。下拉列表、复选框、文本框等控件会产生参数值，这些值均可以通过$dialog_box.controls["control_1"]进行读取，"control_1"为具体的控件名称。