OneNote插件 Onetastic插件 對話框函數(shù)小結(jié)模板分享

?Onetastic中提供的函數(shù)并不多，真正重要的其實只有以下四類：數(shù)組、對話框、對象、字符串。通過這四個類別，基本上可以滿足日常需求了。

本文重點介紹對話框函數(shù)（DialogBoxFunctions）。

對話框為用戶提供了一個可視化的交互界面，使用對話框，可以讓腳本的功能變得更加全面，用起來也更加方便。

DialogBox函數(shù)大類中提供了7個相關(guān)函數(shù)，分別是：DialogBox_AddCheckBox、DialogBox_AddColorPicker、DialogBox_AddDropDown、DialogBox_AddLabel、DialogBox_AddTextBox、DialogBox_Create、DialogBox_Show。其中，DialogBox_AddColorPicker是后期新加入的函數(shù)，另外6個從初期開始就一直存在，相當?shù)湫汀⒅匾�。下面簡要介紹每個函數(shù)的基本用法。

1.DialogBox函數(shù)介紹

DialogBox_AddCheckBox，復(fù)選框，勾選代表true，不勾選代表false。

DialogBox_AddColorPicker，顏色選擇器，后期新增函數(shù)，不常用。

DialogBox_AddDropDown，下拉列表，分類處理。

DialogBox_AddLabel，文字標簽，可以在將說明或備注文字添加到對話框上。

DialogBox_AddTextBox，文本框，多用于輸入自定義參數(shù)。

以上5個函數(shù)是具體的控件函數(shù)，這些控件都可以直接添加到對話框的界面中，并且都會添加到DialogBox對象中的controls屬性中。下拉列表、復(fù)選框、文本框等控件會產(chǎn)生參數(shù)值，這些值均可以通過$dialog_box.controls["control_1"]進行讀取，"control_1"為具體的控件名稱。

DialogBox_Create，創(chuàng)建對話框，該方法會創(chuàng)建一個DialogBox對象，必須先創(chuàng)建DialogBox對象，然后才能添加具體控件。

DialogBox_Show，顯示對話框。控件添加完畢后，一定要記得調(diào)用該方法顯示對話框，否則，對話框是不會顯示的。

2.DialogBox應(yīng)用模板

最近，對話框用的比較頻繁，所以抽時間寫了一個通用模板，以后用到時可以直接在模板的基礎(chǔ)上進行改寫，而不用重寫一行行代碼了。

該腳本分享的只是對話框的模板，里面包含了所有常用控件（顏色選擇器除外，用的少），按實際情況添加具體處理方法即可。