Windows 應用程式的控制項

控制項是構成你 Windows 應用程式的介面元素——按鈕、文字欄位、清單、選擇器等等。 控制點顯示內容或讓使用者與你的應用程式互動。模式將多個控制項組合成一個可重複使用的常見場景配方，如表單或清單細節配置。

Windows 提供超過 45 個即用控制系統，全部基於 Fluent 設計系統。從簡單的切換到豐富的資料視圖如格子和清單，這些控制項幫助你打造視覺上精緻、易於存取且跨裝置反應靈敏的介面。

請瀏覽本節文章，了解設計指引、程式碼範例及每個控制項與模式的最佳實務。

開始使用

想了解如何在應用程式中新增控制項並連接事件處理程式，請參見新增控制項與處理事件。若要自訂可重複使用的 XAML 樣式控制外觀，請參見「樣式控制項」。

下表列出 WinUI 中可用的 Windows 應用程式控制項，並附有相關文件連結。

影像	管理	說明
	按鈕	一個能回應使用者輸入並引發點擊事件的控制項。包含按鈕、下拉按鈕、分割按鈕、切換按鈕等功能。
	複選框	使用者可以選擇或清除控制項。
	組合盒	一個下拉選單，讓使用者可以選擇項目。
	Hyperlinks	一個按鈕會以超連結文字形式出現，並能導向 URI 或處理點擊事件。
	單選按鈕	一個控制項，允許使用者從一組選項中選擇單一選項。
	評級控制	給某件事打1到5星。
	滑桿	一個控制鍵，使用者可以透過沿軌道移動拇指控制鍵，從多個數值中選擇。
	切換開關	一個可以在兩個狀態間切換的開關。

影像	管理	說明
	項目檢視	一個以各種佈局呈現一系列項目的控制元件。
	清單檢視和方格檢視	控制項會以垂直列表或列列的形式呈現一組項目。
	翻轉檢視	呈現一組項目，使用者可以逐項翻閱。
	Pips 呼叫器	一個控制項，讓使用者在不需要查看頁碼時，能在分頁內容中導航。
	樹狀檢視	一種階層式清單模式，包含包含巢狀項目的擴充與摺疊節點。
	項目重覆器	一種靈活且基本的控制，適用於資料驅動的佈局。
	滑動	觸控手勢可快速執行項目的選單操作。
	拖動以重新整理	提供拉取清單/網格中項目集合以刷新該集合內容的能力。

影像	管理	說明
	對話框	一個可自訂以包含任何 XAML 內容的對話框。
	快顯功能表	顯示上下文資訊並促進使用者互動。
	教學小技巧	一個內容豐富的下拉式選單，用於指導使用者並創造學習時機。

影像	管理	說明
	表單	一種結合輸入控制與標籤來收集與提交使用者輸入的模式。

影像	管理	說明
	圖示	使用不同圖片類型的圖示控制項來表示內容。
	動畫圖示	一個顯示並控制圖示的元素，當使用者操作該控制器時，圖示會自動啟動。
	影像與影像筆刷	一個用來顯示圖片內容的控制器。
	墨水	數位墨水技術的控制項，包括墨水畫布和墨水工具列。
	媒體播放	一個用來顯示影片和影像內容的控制器。
	形狀	畫出橢圓形、矩形和多邊形等形狀。

影像	管理	說明
	選單和快捷選單	顯示一份簡單指令或選項的情境清單。
	命令列	一個用於顯示應用程式特定指令的工具列，負責內容的版面配置與調整大小。
	命令欄彈出視窗	一個顯示主動指令的小工具列，以及一個可選的指令選單。
	選單彈出視窗和選單列	典型的選單，允許顯示包含「選單展開項目」的「選單項目」。

影像	管理	說明
	麵包屑條	顯示通往當前位置的導航路徑。
	清單/詳細數據	一個圖案會顯示一份物品清單，並列出目前所選物品的詳細資訊。
	導覽檢視	透過可摺疊的導覽選單，為應用程式頂層區域提供常見的垂直佈局。
	樞紐	以分頁視圖呈現來自不同來源的資訊。
	選擇列	呈現來自少數不同來源的資訊。使用者可以選擇其中一種。
	頁籤檢視	一個控制項，顯示一組可用於展示多個文件的標籤頁。

影像	管理	說明
	人物照片	顯示某人或聯絡人的照片。

影像	管理	說明
	擴展器	一個帶有可展開標題以顯示內容較多的主體的容器。
	捲動與平移控制	一個容器控制項，讓使用者可以平移和縮放內容。
	註解捲軸	一個可擴充一般垂直捲軸功能的控制項，方便你在大型資料庫中輕鬆瀏覽。
	語意式縮放	讓使用者能在收藏的兩個不同視角間切換，讓瀏覽大量物品更方便。
	分割檢視	一個有兩個內容區的容器，窗格有多種顯示選項。
	雙窗格視圖	一個有兩個內容區域的控制元件，它們橫跨可用空間，可以是並排或上下排列。

影像	管理	說明
	自動提示框	一個在使用者輸入時提供建議的控制項。
	文字區塊	一個輕量化的控制裝置，用來顯示少量文字。
	豐富文本區塊	一個顯示格式化文字、超連結、內嵌圖片及其他豐富內容的控制項。
	文字方塊	單行或多行純文字欄位。
	RichEdit 方塊	一個支援格式化文字、超連結及其他豐富內容的富文本編輯控制。
	密碼方塊	用於輸入密碼的控制元件。
	數字框	用於數值輸入與代數方程計算的文字控制項。
	標籤	關於在輸入控制項中新增可存取標籤的指引。