1. 概述
1.1 應用場景
1.1.1 填報應用
填報報表中可以通過該控件下拉選擇多個選項信息，錄入填報的數據，如下圖所示：
1.1.2 參數應用
參數面板處可以通過該控件下拉選擇多個選項信息，鍵入查詢參數，如下圖所示：
1.2 添加控件
1.2.1 填報應用
選中單元格後，點擊右側屬性面板的控件設置，選擇控件處下拉選擇下拉複選框控件，如下圖所示：
1.2.2 參數應用
将參數面板控件工具欄中的下拉複選框控件拖入到參數面板中，如下圖所示：
2. 控件介紹
2.1 控件屬性
2.1.1 填報應用
下拉複選框控件的屬性設置界面如下圖所示：
各屬性設置項的詳細介紹如下：
控 件 名：通常與參數結合使用，通過控件名可以獲得該控件，從而獲得控件值傳遞給對應參數；或者通過控件名獲得控件後通過 JS 設置控件的屬性。
可 用：勾選後，填報時可正常輸入文本信息；不勾選，填報時控件灰化，不可編輯。
可 見：勾選後，填報時控件可見；不勾選，填報時控件不可見。
水 印：填報時控件内會顯示淺灰色水印文字，以提示用戶需要輸入的信息，當點擊控件編輯區域後，水印消失。
标簽形式顯示：控制多選按鈕的顯示特效，默認勾選。
數據字典：數據字典可以定義下拉框實際值與顯示值，詳細内容參見文檔：數據字典。
返回值類型：分爲數組和字符串兩種。
允許爲空：勾選後，允許控件爲空值；不勾選，填報校驗和提交時會提示：不能爲空。
錯誤提示：用戶可自定義不允許爲空的提示信息。
允許直接編輯：勾選後，用戶可以直接輸入值，實現模糊查詢。
允許自定義值：勾選後，用戶手動輸入的值可以不包含在下拉菜單選項中；不勾選，用戶手動輸入的值必須是下拉菜單選項中的值，若輸入的值不屬於下拉菜單選中，查詢時，會提示：值不在下拉列表内。
2.1.2 參數應用
下拉複選框控件的屬性設置界面如下圖所示：
各屬性設置項的詳細介紹如下：
控件名稱：通常與參數結合使用，通過控件名可以獲得該控件，從而獲得控件值傳遞給對應參數；或者通過控件名獲得控件後通過 JS 設置控件的屬性。
可 用：勾選後，預覽時可正常輸入文本信息；不勾選，預覽時控件灰化，不可編輯。
可 見：勾選後，預覽時控件可見；不勾選，預覽時控件不可見。
标簽名稱：标簽名稱的作用就是用來彌補參數界面中标簽控件不支持的問題。
控 件 值 ：控件默認顯示的值，詳細内容參見文檔：控件默認值。
數據字典：數據字典可以定義下拉框實際值與顯示值，詳細内容參見文檔：數據字典。
去除重複項：勾選後，會将下拉菜單中相同的項合并；不勾選，會保留下拉菜單中重複的選項。
水 印：控件内會顯示淺灰色水印文字，以提示用戶需要輸入的信息，當點擊控件編輯區域後，水印消失。
字體大小：文本框中輸入字體的大小。
标簽形式顯示：控制多選按鈕的顯示特效，默認勾選。
返回值類型：分爲數組和字符串兩種，後面會詳細介紹。
允許爲空：勾選後，允許控件爲空值；不勾選，查詢時會提示：不能爲空。
錯誤提示：用戶可自定義不允許爲空的提示信息。
允許直接編輯：勾選後，用戶可以直接輸入值，實現模糊查詢。
允許自定義值：勾選後，用戶手動輸入的值可以不包含在下拉菜單選項中；不勾選，用戶手動輸入的值必須是下拉菜單選項中的值，若輸入的值不屬於下拉菜單選中，查詢時，會提示：值不在下拉列表内。
控件位置：調整控件在參數面板中的位置。
控件大小：調整控件的大小。
2.2 校驗
1）允許爲空
勾選後，可以不選擇任何值；不勾選，不選擇任何值時可自定義錯誤提示，如下圖所示：
2）允許直接編輯
下拉複選框控件的編輯框裏面允許直接輸入值，并實現模糊查詢，主要用於在下拉框中快速查找，如下圖所示：
3）允許自定義值
允許在下拉複選框中手動輸入值，不一定要在下拉列表中有對應數據相匹配。不允許在下拉複選框中手動輸入，只能在列表中選擇，如下圖所示：
2.3 高級
1）數據字典
通過數據字典來定義下拉複選框實際值與顯示值，可參考文檔數據字典，如下圖所示：
注1：下拉框實現的是異步加載功能，即每次加載 500 條數據，因此若是大數據量的表就不會出現下拉框一直處在正在加載的情況了。同樣下拉複選框與下拉樹也是異步加載數據。
注2：若下拉框數據量大且重複數據多的話，建議在定義下拉框數據字典時，在數據集或者公式處直接取出不重複的數據，以提高性能。
2）去除重複項
勾選後，會将下拉菜單中相同的項合并；不勾選，會保留重複的選項，如下圖所示：
3）标簽形式顯示
默認勾選，顯示效果如下圖所示：
不勾選，顯示效果如下圖所示：
：
4）返回值
數組
返回數組，返回值類型是數組型的效果是：["值 1","值 2","值 3"]，如下圖所示：
字符串
字符串的返回值類型需要定義分隔符，開始符和結束符，即返回的字符串會根據分隔符，開始符和結束符進行顯示。如分隔符，開始符和結束符分别定義成逗号，單引号和單引号的話，則返回值的效果是：'值 1,值 2,值 3'，如下圖所示：
注1：如果下拉框中[顯示值]有符号，比如說半角逗号，那麽在使用下拉框的時候，默認的分隔符也爲半角逗号，在解析的時候會混淆，所以需要修改默認的分隔符，與半角逗号不一樣就行，也就是說下拉框這類控件的顯示值中如果有符号，必須要保證顯示值中的符号與控件的分隔符不一樣。
注2：如果下拉框中[實際值]有符号，比如說半角單引号，那麽在使用下拉框的時候，默認的起始符号爲半角單引号，在解析的時候會導緻數據集 SQL 混淆報錯，需要修改默認的起始符号爲半角雙引号。
3. 注意事項
勾選了允許直接編輯，移動端預覽時不支持直接編輯下拉複選框，如下圖所示：
