Power Apps 中的組合方塊控制項
允許使用者從其提供的選擇中選取項目的控制項。 支援搜尋和多重選取。
描述
組合方塊控制項可讓您搜尋您將選取的項目。 該搜尋是在伺服器端上的 SearchField 屬性執行，因此效能不會受到大型的資料來源影響。
單一或多重選取模式是透過 SelectMultiple 屬性設定。
搜尋要選取的項目時，您可以就個別項目在資料窗格中修改版面配置設定，以選擇要顯示單一資料值、兩個值，還是或一張圖片和兩個值 (人員)。
在小畫面上查看時，項目清單彈出式視窗將成為全畫面控制項，以提高可用性。
注意
如果您想要搜尋含有 數字 的項目，請將數字轉換成含有 text() 函數的文字。 例如， Text(12345)。
限制
組合方塊控制項具有下列限制：
- 如果您使用資源庫內的組合方塊控制項，當使用者捲動資源庫時，不會維護其選取項目。 如果您使用資源庫內未捲動的組合方塊控制項，這就不是問題。 因應措施目前無法使用。
人員選擇器
若要使用組合方塊作為人員選擇器，請從資料窗格中的版面配置設定選擇 人員 範本，並設定要為下方人員顯示的相關資料屬性。
主要屬性
Items – 可從中建立選取的資料來源。
DefaultSelectedItems – 在使用者與控制項互動之前的初始選取項目。
注意
Default 屬性已被取代，請改用 DefaultSelectedItems。
SelectedItems – 因使用者互動選取的項目清單。
SelectMultiple – 使用者是否可以選取單一項目或多個項目。
IsSearchable – 使用者是否可以先搜尋項目再選取。
注意
IsSearchable 只能在包含至少一個文字欄位的資料來源上啟用。 Items 運算式必須是可委派的，以便將查詢與搜尋一起委派。 也就是說，不支援 Items 運算式內的 If 陳述式。
SearchFields - 使用者輸入文字時，搜尋資料來源的資料欄位。
注意
若要搜尋多個欄位，請將 SearchFields 屬性設定為此格式：["MyFirstColumn"、"MySecondColumn"]。 僅支援文字欄位。
其他屬性
AccessibleLabel – 螢幕報讀軟體的標籤。
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
DisplayFields – 針對搜尋傳回的每個項目顯示的欄位清單。 透過屬性選項索引標籤中的資料窗格最容易進行組態。
注意
若要更新特定範本中的多個顯示欄位，請以下列格式設定 DisplayFields 屬性：["MyFirstColumn", "MySecondColumn"]。
DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。
FocusedBorderColor – 當控制項為焦點時的控制項框線色彩。
FocusedBorderThickness – 當控制項為焦點時的控制項框線粗細。
Height – 控制項的頂端和底部邊緣之間的距離。
InputTextPlaceholder – 未選取任何項目時，向使用者顯示的說明文字。
OnChange – 當使用者變更選項時，要執行的動作。
OnNavigate – 使用者選取項目時要執行的動作。
OnSelect – 在使用者選擇或按一下控制項時，要執行的動作。
TabIndex – 相對於其他控制項的鍵盤導覽順序。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (沒有父容器時則為螢幕) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其父容器 (沒有父容器時則為螢幕) 頂部邊緣之間的距離。
注意
彈出式視窗邊框屬性是由 Border 屬性所控制。
範例
基本組合方塊
此範例中的步驟適用於任何提供資料表的資料來源，但是若要完全遵循這些步驟，請使用具有 Microsoft Dataverse 範例資料之資料庫的環境。
選取插入 > 輸入 > 組合方塊，並將其命名為「Combobox1」。
在畫面右側的屬性窗格中，打開選取資料來源清單 (Items旁邊)，然後新增或選取資料來源 (例如帳戶資料表)。
在相同的窗格中，選取編輯 (欄位旁邊)。
在Data窗格中，打開主要文字清單，然後選取將顯示在組合方塊控制項中的主要名稱欄。
按住 Alt 鍵的同時，選取下箭頭開啟組合方塊控制項。
控制項會顯示您在指定資料來源中指定之主要名稱的資料。
(選用) 預設顯示第一則記錄
將 DefaultSelectedItems 屬性設定為此運算式，並將 DataSource 替換為您資料來源的名稱：
First(DataSource)
(選用) 在標籤中顯示選取的帳戶名稱
選取插入 > 文字標籤，然後選取標籤。
將 Text 屬性設定為此運算式，以 Text 取代下列公式：
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")注意
If 陳述式將檢查以瞭解所選取的項目存在方式，並以逗號分隔標籤或在空白時顯示「未選取的項目」訊息。
模擬簡單下拉式行為
透過設定 IsSearchable 為 false 並設定 SelectMultiple 為 false，您就可以達到與下拉式清單的相同功能。
選取插入 > 輸入，然後選取組合方塊。
在畫面右側的屬性窗格中，打開選取資料來源清單 (Items旁邊)，然後新增或選取資料來源。
在相同的窗格中，選取編輯 (欄位旁邊)。
在 Data 窗格中，開啟 Primary text 清單，然後選取您要在組合方塊控制項中顯示的欄位。
將 IsSearchable 屬性設為 false。
將 SelectMultiple 屬性設為 false。
按住 Alt 鍵的同時，選取下箭頭開啟組合方塊控制項。
控制項顯示您在指定資料來源中指定欄位的資料。
注意
「尋找項目」文字消失，而且您只能選取單一項目。
協助工具指南
色彩對比
以下項目之間必須有足夠的色彩對比：
- ChevronFill 和 ChevronBackground
- ChevronHoverFill 和 ChevronHoverBackground
- SelectionColor 和 SelectionFill
- SelectionFill 和 Fill
- SelectionTagColor 和 SelectionTagFill
這是 標準色彩對比要求 之外的要求。
螢幕助讀程式支援
AccessibleLabel 必須存在。
注意
在觸控螢幕控制項上，螢幕助讀程式使用者可依序導覽組合方塊的內容。 選取時，組合方塊可作為顯示或隱藏其內容的按鈕。
鍵盤支援
TabIndex 必須是零或大於零，鍵盤使用者才能導覽到該處。
焦點指標必須清楚可見。 使用 FocusedBorderColor 和 FocusedBorderThickness 達成此目的。
注意
索引標籤鍵可導覽到或離開組合方塊。 方向鍵可導覽組合方塊的內容。 開啟時，Esc 鍵可關閉下拉式清單。