ListView 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示在垂直堆疊中顯示資料項的控制件。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ListView : ListViewBase[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ListView : ListViewBasePublic Class ListView
Inherits ListViewBase<ListView .../>
-or-
<ListView ...>
oneOrMoreItems
</ListView>
- 繼承
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ItemsControl Selector ListViewBase ListView
- 衍生
- 屬性
Windows 需求
| 規格需求 | Description |
|---|---|
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)
|
範例
Tip
更多資訊、設計指導及程式碼範例，請參閱 列表檢視。
WinUI 2 圖庫應用程式包含了大部分 WinUI 2 控制項、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式，或在 GitHub 上取得原始程式碼。
在此範例中，ListView 的 ItemTemplate 是內聯定義的。 因為 ItemsSource 是設定的， ItemTemplate 會套用到每個項目。
<ListView x:Name="itemListView"
Margin="120,0,0,60"
ItemsSource="{Binding Source={StaticResource itemsViewSource}}"
SelectionChanged="ItemListView_SelectionChanged">
<ListView.ItemTemplate>
<DataTemplate>
<Grid Height="110" Margin="6">
<Grid.ColumnDefinitions>
<ColumnDefinition Width="Auto"/>
<ColumnDefinition Width="*"/>
</Grid.ColumnDefinitions>
<Border Background="{StaticResource ListViewItemPlaceholderBackgroundThemeBrush}" Width="110" Height="110">
<Image Source="{Binding Image}" Stretch="UniformToFill"/>
</Border>
<StackPanel Grid.Column="1" VerticalAlignment="Top" Margin="10,0,0,0">
<TextBlock Text="{Binding Title}" Style="{StaticResource TitleTextStyle}" TextWrapping="NoWrap"/>
<TextBlock Text="{Binding Subtitle}" Style="{StaticResource CaptionTextStyle}" TextWrapping="NoWrap"/>
<TextBlock Text="{Binding Description}" Style="{StaticResource BodyTextStyle}" MaxHeight="60"/>
</StackPanel>
</Grid>
</DataTemplate>
</ListView.ItemTemplate>
</ListView>
<ListView>
<ListView.ItemTemplate>
<DataTemplate>
<Grid>
<Border Background="LightGray" Height="200" Width="200">
<TextBlock Text="{Binding}"
FontSize="48" Foreground="Green"/>
</Border>
</Grid>
</DataTemplate>
</ListView.ItemTemplate>
<ListView.Items>
<x:String>One</x:String>
<ListViewItem>Two</ListViewItem>
</ListView.Items>
</ListView>
以下範例中，應用程式中每個 ListView 項目的角落都被四捨五入為 5px。
<Application.Resources>
<CornerRadius x:Key="ListViewItemCornerRadius">5</CornerRadius>
</Application.Resources>
備註
Tip
如需詳細資訊、設計指引和程式碼範例，請參閱 清單檢視和方格檢視。
使用 ListView 顯示一組垂直或水平堆疊的項目集合。 若要在資料列和資料列中顯示集合，請使用 GridView。
ListView 是 ItemsControl，因此它可以包含任何類型的專案集合。 若要填入檢視，請將專案新增至 Items 集合，或將 ItemsSource 屬性設定為數據源。
根據預設，數據項會顯示在 ListView 中，做為系結至之數據物件的字串表示。 若要確切指定 ListView 中的項目顯示方式，您可以建立 DataTemplate，以定義用來顯示個別專案的控件配置。 配置中的控制項可以繫結至資料物件的屬性，或以內嵌方式定義內容。 您可以將 DataTemplate 指派給 ListView 的 ItemTemplate 屬性。 如需可在應用程式中使用的常見範本，請參閱 listView
備註
如果您藉由設定 ItemsSource 屬性來填入 ListView，則會將 ItemTemplate 套用至每個專案。 如果您直接填入 Items 集合，只有當專案不是 ListViewItem時，才會套用 ItemTemplate。 更多資訊請參見範例。
如果您使用 ListView 來顯示大量數據集，請參閱 Optimize ListView 和 GridView，以取得維持順暢且回應式用戶體驗的秘訣。
Important
UI 虛擬化需要捲動方向的有界版面配置。 ListView 利用 UI 虛擬化，透過只為靠近視窗的項目建立物品容器，有效率地渲染大型清單。 此優化要求列表檢視在捲動方向上受到限制（垂直列表為高度，橫向列表為寬度）。 如果你將 ListView 放在一個提供無限空間的容器中，例如 StackPanel 或 ScrollViewer，ListView 無法判斷哪些項目是可見的，會為 所有 項目建立容器，破壞虛擬化，並可能造成嚴重的效能問題。
為了保留虛擬化，將 ListView 放入一個有限制其大小的版面容器中，例如具有定義高度或*大小的網格列。
Windows 10，版本 1709（SDK 16299）- 行為變更預設情況下，主動筆不再執行選取，而是在 UWP 應用程式中（如觸控、觸控板和被動筆）中捲動或平移清單。 如果你的應用程式依賴於先前的行為，你可以禁用筆滾動並恢復到之前的行為。 詳情請參見 ScrollViewer 。
根據預設，用戶可以在 ListView 中選取單一專案。 您可以將 SelectionMode 屬性設定為 ListViewSelectionMode 列舉值，以允許多重選取或停用選取。 您也可以變更 ListView 互動模式，讓專案像按鈕一樣回應使用者按兩下，而不是被選取。
下表顯示使用者可以與 ListView 互動的方式，以及如何響應互動。
| 若要啟用此互動： | 請使用以下設定： | 處理這個事件： | 使用此屬性來取得選取的項目： |
|---|---|---|---|
| 無互動 | SelectionMode = NoneIsItemClickEnabled = False | N/A | N/A |
| 單選 | SelectionMode = SingleIsItemClickEnabled = False | 選擇已更改 | SelectedItemSelectedIndex |
| 連續多重選取 | SelectionMode = MultipleIsItemClickEnabled = False | 選擇已更改 | 選擇的項目 |
| 非連續多重選取 | SelectionMode = Extended，IsItemClickEnabled = False | 選擇已更改 | 選擇的項目 |
| Click | SelectionMode = NoneIsItemClickEnabled = True | ItemClick \(英文\) | N/A |
備註
PointerWheelChanged 事件不會從 ListView 升起。 這表示如果指標位於 ListView 上方，則具有 ListView 內的控件不會收到滑鼠滾輪變更訊息。 例如，如果您將 ListView 放在
ListView 支援數據虛擬化，以改善大型數據集的效能。 當數據源實作適當的介面時，支援隨機存取虛擬化，視程式設計語言而有所不同：
- Visual C++ 元件擴充功能（C++/CX）應用程式應該實作 IObservableVector。
- C# 或 Visual Basic 應用程式應該實作 INotifyCollectionChanged 和 System.Collections.IList（不是 IList<T>）。 虛擬化需要這兩個介面。 當數據源實作 ISupportIncrementalLoading 介面時，支援累加式載入虛擬化。 支援累加式載入時，您可以使用這些成員來控制數據載入：DataFetchSize、IncrementalLoadingThreshold、IncrementalLoadingTrigger、LoadMoreItemsAsync。
Windows 8 在 Windows 8 中，當選取的 ListViewItem 中的資料項目被替換時，SelectedIndex 的值不會被清除。 在 Windows 8.1 或更新版本中，SelectIndex 值會被清除。
ListView 會實作 ISemanticZoomInformation 介面，因此它可以做為 SemanticZoom 控件中的檢視。 在 SemanticZoom 控件中使用時，請一律將 ScrollViewer.IsVerticalScrollChainingEnabled 附加屬性設定為在 ListView 控件範本中的 ScrollViewerfalse，如下所示：<ListView ScrollViewer.IsVerticalScrollChainingEnabled="False">。 只有當 ListView 裝載於 SemanticZoom 控件時，這些成員才會有效果：IsActiveView、IsZoomedInView、SemanticZoomOwner、CompleteViewChange、 CompleteViewChangeFrom、CompleteViewChangeTo、InitializeViewChange、MakeVisible、StartViewChangeFromStartViewChangeTo。
如果你需要在可捲動視圖（例如 ScrollViewer）中處理 UIElement 的指標事件，必須透過呼叫 UIElement.CancelDirectmanipulation（），明確停用該元素對操作事件的支援。 若要在檢視中重新啟用操作事件，請呼叫 UIElement.TryStartDirectManipulation()。
選擇行為與 CollectionViewSource
清單控件衍生自 Selector 具有預設選取行為，取決於專案來源是什麼（用於 ItemsSource的類型）。 如果項目來源是 CollectionViewSource 實例，那麼選擇控制項的行為是選擇會預設為目前的項目。 當清單首次顯示時，選擇預設為第一個項目為當前項目。 如果您不想在此案例中選取第一個專案，請將
WinUI 2.6 的視覺更新
在 WinUI 2.6 中，新增了 API 和樣式以更新 ListView 的視覺化與設計。 這些更新的視覺效果包括圓角、選擇指示器等。
如果你想使用這些新樣式，首先要確保你的應用程式使用 WinUI 2.6。 要設定 WinUI 2，請參考「開始使用 Windows UI 2.x 函式庫」。
你也可以在應用程式中指定 Xaml 資源來修改 ListView 的外觀。 WinUI 2.6 新增的資源是 ListViewItemCornerRadius，它控制 ListViewItem 角落的捨入程度。 預設情況下，這個主題資源設定為 4px。
建構函式
| 名稱 | Description |
|---|---|
| ListView() |
初始化 listView 類別 |
屬性
| 名稱 | Description |
|---|---|
| AccessKey |
取得或設定此元素的存取鍵（助記鍵）。 (繼承來源 UIElement) |
| AccessKeyScopeOwner |
取得或設定一個來源元素，提供該元素的存取鍵作用域，即使該元素不在原始元素的視覺樹中。 (繼承來源 UIElement) |
| ActualHeight |
會取得 FrameworkElement 的渲染高度。 請參閱備註。 (繼承來源 FrameworkElement) |
| ActualOffset |
取得此 UIElement 相對於其父節點的位置，該位置是在佈局流程的排列過程中計算出來的。 (繼承來源 UIElement) |
| ActualSize |
取得該 UIElement 在佈局流程安排過程中計算出的大小。 (繼承來源 UIElement) |
| ActualTheme |
取得該元素目前使用的 UI 主題，這可能和 RequestedTheme 不同。 (繼承來源 FrameworkElement) |
| ActualWidth |
它會取得 FrameworkElement 的渲染寬度。 請參閱備註。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定一個值，判斷該 UIElement 是否能作為拖放操作的丟棄目標。 (繼承來源 UIElement) |
| AllowFocusOnInteraction |
會獲得或設定一個值，指示該元素在使用者互動時是否自動獲得焦點。 (繼承來源 FrameworkElement) |
| AllowFocusWhenDisabled |
取得或設定失效控制是否能接收焦點。 (繼承來源 FrameworkElement) |
| Background |
取得或設定一個畫筆作為控制背景。 (繼承來源 Control) |
| BackgroundSizing |
取得或設定一個值，表示背景相對於該元素邊界的延伸距離。 (繼承來源 Control) |
| BaseUri |
取得一個統一資源識別碼（URI），代表 XAML 載入時所建構物件的基礎統一資源識別碼（URI）。 此特性對於執行時的統一資源識別碼（URI）解析非常有用。 (繼承來源 FrameworkElement) |
| BorderBrush |
取得或設定一個筆刷，描述控制點的邊框填充。 (繼承來源 Control) |
| BorderThickness |
取得或設定控制區的邊框厚度。 (繼承來源 Control) |
| CacheMode |
取得或設定一個值，表示渲染內容應盡可能以合成點陣圖形式快取。 (繼承來源 UIElement) |
| CanBeScrollAnchor |
取得或設定一個值，指示 UIElement 是否適合作為捲動錨定的候選對象。 (繼承來源 UIElement) |
| CanDrag |
取得或設定一個值，指示該元素是否能以拖放操作的方式被拖曳為資料。 (繼承來源 UIElement) |
| CanDragItems |
取得或設定值，這個值表示檢視中的專案是否可以拖曳為數據承載。 (繼承來源 ListViewBase) |
| CanReorderItems |
取得或設定值，這個值表示檢視中的專案是否可以透過用戶互動重新排序。 (繼承來源 ListViewBase) |
| CenterPoint |
取得或設定元素的中心點，即旋轉或縮放發生的中心點。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| CharacterSpacing |
取得或設定字元間的均勻間距，單位為 1/1000 的 em。 (繼承來源 Control) |
| Clip |
取得或設定用於定義 UIElement 內容輪廓的矩形幾何。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定一個屬性，宣告該元素在其父版面配置與視窗中的替代合成與混合模式。 這對於涉及混合 XAML / Microsoft DirectX UI 的元素非常重要。 (繼承來源 UIElement) |
| ContextFlyout |
取得或設定與此元素相關的飛出。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控制點邊界角落的半徑。 (繼承來源 Control) |
| DataContext |
取得或設定 FrameworkElement 的資料上下文。 資料上下文的常見用途是當 FrameworkElement 使用 {Binding} 標記擴充並參與資料綁定時。 (繼承來源 FrameworkElement) |
| DataFetchSize |
取得或設定要擷取以虛擬化/預先擷取作業的數據量。 (繼承來源 ListViewBase) |
| DefaultStyleKey |
取得或設定指向該控制項預設風格的鍵。 自訂控制項的作者會利用這個屬性來更改他們控制項所用風格的預設值。 (繼承來源 Control) |
| DefaultStyleResourceUri |
取得或設定包含控制項預設樣式的資源檔案路徑。 (繼承來源 Control) |
| DesiredSize |
取得該 UIElement 在佈局過程的測度通過時計算出的大小。 (繼承來源 UIElement) |
| Dispatcher |
取得該物件所關聯的核心 派遣器 。 CoreDispatcher 代表一個設施，即使程式碼是由非 UI 執行緒發起，也能存取 UI 執行緒上的 DependencyObject。 (繼承來源 DependencyObject) |
| DisplayMemberPath |
取得或設定每個資料項目所顯示屬性的名稱或路徑。 (繼承來源 ItemsControl) |
| ElementSoundMode |
取得或設定一個值，指定控制項偏好是否播放聲音。 (繼承來源 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定一個值，指定在呼叫存取鍵時是否會關閉存取鍵顯示。 (繼承來源 UIElement) |
| FlowDirection |
它設定文字及其他 UI 元素在任何控制其版面配置的父元素內流動的方向。 此屬性可設定為 LeftToRight 或 RightToLeft。 將 FlowDirection 設定為 RightToLeft ，即可將對齊設定為右向左，讀取順序為右至左，控制項的配置則由右向左流動。 (繼承來源 FrameworkElement) |
| FocusState |
會得到一個值，指定此控制是否具備對焦功能，以及取得對焦的方式。 (繼承來源 Control) |
| FocusVisualMargin |
取得或設定 FrameworkElement 焦點視覺化的外圍。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定用來繪製框架 |
| FocusVisualPrimaryThickness |
取得或設定框架 |
| FocusVisualSecondaryBrush |
取得或設定用來繪製框架 |
| FocusVisualSecondaryThickness |
取得或設定框架 |
| FontFamily |
取得或設定用於控制項中顯示文字的字型。 (繼承來源 Control) |
| FontSize |
在此控制項中取得或設定文字大小。 (繼承來源 Control) |
| FontStretch |
決定字體在螢幕上的濃縮或擴展程度。 (繼承來源 Control) |
| FontStyle |
取得或設定文字呈現的樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
| Footer |
取得或設定清單頁尾的內容。 (繼承來源 ListViewBase) |
| FooterTemplate |
取得或設定用來顯示檢視頁尾內容的 DataTemplate。 (繼承來源 ListViewBase) |
| FooterTransitions |
取得或設定套用至檢視頁尾的 Transition 樣式專案集合。 (繼承來源 ListViewBase) |
| Foreground |
取得或設定一筆筆來描述前景色。 (繼承來源 Control) |
| GroupStyle |
取得一組 GroupStyle 物件，定義每個群組層級的外觀。 (繼承來源 ItemsControl) |
| GroupStyleSelector |
取得或設定一個自訂 GroupStyleSelector 邏輯類別的參考。 GroupStyleSelector 會根據內容特性回傳不同的 GroupStyle 值來使用。 (繼承來源 ItemsControl) |
| Header |
取得或設定清單標頭的內容。 (繼承來源 ListViewBase) |
| HeaderTemplate |
取得或設定用來顯示檢視標頭內容的 DataTemplate。 (繼承來源 ListViewBase) |
| HeaderTransitions |
取得或設定套用至檢視標頭 Transition 樣式專案的集合。 (繼承來源 ListViewBase) |
| Height |
取得或設定 FrameworkElement 的建議高度。 (繼承來源 FrameworkElement) |
| HighContrastAdjustment |
取得或設定一個值，指示框架在啟用高對比主題時是否自動調整元素的視覺屬性。 (繼承來源 UIElement) |
| HorizontalAlignment |
取得或設定在 FrameworkElement 組合於版面父元件（如面板或項目控制項）時套用的水平對齊特性。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 (繼承來源 Control) |
| IncrementalLoadingThreshold |
取得或設定當 listViewBase 類別 |
| IncrementalLoadingTrigger |
取得或設定值，這個值表示 ListViewBase 類別預先擷取作業的條件。 (繼承來源 ListViewBase) |
| IsAccessKeyScope |
取得或設定一個值，指示元素是否定義其存取鍵作用域。 (繼承來源 UIElement) |
| IsActiveView |
取得或設定值，這個值表示 ListViewBase 實例是否為其擁有 SemanticZoom的作用中檢視。 (繼承來源 ListViewBase) |
| IsDoubleTapEnabled |
取得或設定一個值，決定 DoubleTapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定一個值，指示使用者是否能與控制項互動。 (繼承來源 Control) |
| IsFocusEngaged |
取得或設定一個值，指示焦點是否被限制在控制範圍內（針對遊戲手把/遠端互動）。 (繼承來源 Control) |
| IsFocusEngagementEnabled |
取得或設定一個數值，指示焦點是否能在控制範圍內被限制（針對遊戲手把/遠端互動）。 (繼承來源 Control) |
| IsGrouping |
會得到一個值，表示對照是否使用分組。 (繼承來源 ItemsControl) |
| IsHitTestVisible |
取得或設定此 UIElement 所包含區域是否能回傳真實值以進行命中測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定一個值，決定 持有事件是否 能從該元素產生。 (繼承來源 UIElement) |
| IsItemClickEnabled |
取得或設定值，指出檢視中的專案是否引發 ItemClick 事件，以響應互動。 (繼承來源 ListViewBase) |
| IsLoaded |
會得到一個值，表示該元素是否已被加入元素樹並準備好進行互動。 (繼承來源 FrameworkElement) |
| IsMultiSelectCheckBoxEnabled |
取得或設定值，這個值表示是否顯示複選框來啟用多重選取。 (繼承來源 ListViewBase) |
| IsRightTapEnabled |
取得或設定一個值，決定 RightTapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsSwipeEnabled |
取得或設定值，這個值表示檢視是否支援 撥動 互動的離散輸入處理。 (繼承來源 ListViewBase) |
| IsSynchronizedWithCurrentItem |
取得或設定一個值，指示選擇器是否應該在 Items 屬性中保持 SelectedItem 與當前項目同步。 (繼承來源 Selector) |
| IsTabStop |
取得或設定一個值，指示分頁導覽中是否包含某個控制項。 (繼承來源 Control) |
| IsTapEnabled |
取得或設定一個值，決定 Tapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動文字放大（反映系統文字大小設定）。 (繼承來源 Control) |
| IsZoomedInView |
取得或設定值，這個值表示 ListViewBase 實例是否為其擁有 SemanticZoom中的縮放檢視。 (繼承來源 ListViewBase) |
| ItemContainerGenerator |
會取得與此 ItemsControl 關聯的 ItemContainerGenerator。 (繼承來源 ItemsControl) |
| ItemContainerStyle |
取得或設定用於渲染物品容器時使用的樣式，用於 ItemsControl。 (繼承來源 ItemsControl) |
| ItemContainerStyleSelector |
取得或設定一個自訂 StyleSelector 邏輯類別的參考。 StyleSelector 會根據物件的特性回傳不同的 Style 值，供物品容器使用。 (繼承來源 ItemsControl) |
| ItemContainerTransitions |
取得或設定一套適用於 ItemsControl 物品容器的 Transition 風格元素集合。 (繼承來源 ItemsControl) |
| Items |
取得用於產生控制內容的集合。 (繼承來源 ItemsControl) |
| ItemsPanel |
取得或設定範本，這個範本會定義控制專案配置的面板。 (繼承來源 ItemsControl) |
| ItemsPanelRoot |
取得由 ItemsPanel 指定的面板。 (繼承來源 ItemsControl) |
| ItemsSource |
取得或設定一個物件來源，用來產生 ItemsControl 的內容。 (繼承來源 ItemsControl) |
| ItemTemplate |
取得或設定用於顯示每個項目的資料 範本 。 (繼承來源 ItemsControl) |
| ItemTemplateSelector |
取得或設定一個自訂 DataTemplateSelector 邏輯類別的參考。 此屬性所參考的 DataTemplateSelector 會回傳一個範本以套用於項目。 (繼承來源 ItemsControl) |
| KeyboardAcceleratorPlacementMode |
取得或設定一個值，指示控制 工具提示是否顯示 其對應鍵盤加速器的按鍵組合。 (繼承來源 UIElement) |
| KeyboardAcceleratorPlacementTarget |
取得或設定一個值，指示顯示加速器按鍵組合的控制 工具提示 。 (繼承來源 UIElement) |
| KeyboardAccelerators |
取得一組按鍵組合，用鍵盤觸發動作。 加速器通常分配給按鈕或選單項目。
|
| KeyTipHorizontalOffset |
會取得或設定一個值，表示鍵尖相對於 UIElement 的位置有多左或多右。 (繼承來源 UIElement) |
| KeyTipPlacementMode |
取得或設定一個值，指示存取鍵提示相對於 UIElement 邊界的位置。 (繼承來源 UIElement) |
| KeyTipTarget |
取得或設定一個值，指示存取鍵提示所鎖定的元素。 (繼承來源 UIElement) |
| KeyTipVerticalOffset |
它會取得或設定一個值，表示鍵尖相對於 UI 元素的上下位置。 (繼承來源 UIElement) |
| Language |
取得或設定適用於 FrameworkElement 的本地化/全球化語言資訊，同時也適用於物件表示法和 UI 中目前 FrameworkElement 的所有子元素。 (繼承來源 FrameworkElement) |
| Lights |
會讓 XamlLight 物件集合附加到這個元素上。 (繼承來源 UIElement) |
| ManipulationMode |
取得或設定用於 UIElement 行為及手勢互動的 ManipulationModes 值。 設定此值後，能在應用程式程式碼中處理該元素的操作事件。 (繼承來源 UIElement) |
| Margin |
取得或設定 FrameworkElement 的外緣。 (繼承來源 FrameworkElement) |
| MaxHeight |
取得或設定 FrameworkElement 的最大高度限制。 (繼承來源 FrameworkElement) |
| MaxWidth |
取得或設定 FrameworkElement 的最大寬度限制。 (繼承來源 FrameworkElement) |
| MinHeight |
取得或設定 FrameworkElement 的最小高度限制。 (繼承來源 FrameworkElement) |
| MinWidth |
取得或設定 FrameworkElement 的最小寬度限制。 (繼承來源 FrameworkElement) |
| Name |
取得或設定物件的識別名稱。 當 XAML 處理器從 XAML 標記建立物件樹時，執行時程式碼可以以此名稱來指稱 XAML 宣告的物件。 (繼承來源 FrameworkElement) |
| Opacity |
取得或設定物件不透明度的度數。 (繼承來源 UIElement) |
| OpacityTransition |
取得或設定 ScalarTransition，用來動畫化 Opacity 屬性的變更。 (繼承來源 UIElement) |
| Padding |
在控制區內取得或設定填充物。 (繼承來源 Control) |
| Parent |
取得物件樹中 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
| PointerCaptures |
取得所有捕獲指標的集合，以 指標 值表示。 (繼承來源 UIElement) |
| Projection |
在渲染這個元素時，會取得或設定投影（3D 效果）來套用。 (繼承來源 UIElement) |
| RenderSize |
會取得 UIElement 的最終渲染大小。 不建議使用此，詳見備註。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定影響 UIElement 渲染位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform 宣告的任何可能渲染轉換的起點，相對於 UIElement 的界限。 (繼承來源 UIElement) |
| ReorderMode |
取得或設定 ListViewBase 實例的重新排序行為。 啟用時，使用者操作可以重新排序未排序和未分組的清單。 (繼承來源 ListViewBase) |
| RequestedTheme |
取得或設定 UI 主題，該主題由 UIElement （及其子元素）用於資源判定。 你用 RequestedTheme 指定的 UI 主題可以覆蓋應用程式層級 的 RequestedTheme。 (繼承來源 FrameworkElement) |
| RequiresPointer |
可設定或設定 UI 元素是否支援滑鼠模式，模擬與非指標輸入裝置（如遊戲手把或遙控器）的指標互動體驗。 (繼承來源 Control) |
| Resources |
取得本地定義的資源字典。 在 XAML 中，你可以透過 XAML 隱含的集合語法，將資源項目建立為屬性元素的 |
| Rotation |
設定順時針旋轉的角度，以度數為單位。 相對於旋轉軸和中心點旋轉。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| RotationAxis |
讓軸線旋轉元素。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，讓 Rotation 屬性的變化動畫化。 (繼承來源 UIElement) |
| Scale |
取得或設定元素的比例。 相對於元素的中心點進行縮放。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，用來動畫化 Scale 屬性的變更。 (繼承來源 UIElement) |
| SelectedIndex |
取得或設定所選項目的索引。 (繼承來源 Selector) |
| SelectedItem |
取得或設定選取的項目。 (繼承來源 Selector) |
| SelectedItems |
會取得目前選中的物品。 (繼承來源 ListViewBase) |
| SelectedRanges |
取得 ItemIndexRange 物件集合，這些物件描述清單中目前選取的專案。 (繼承來源 ListViewBase) |
| SelectedValue |
取得或設定所選項目的值，該值是透過 SelectedValuePath 取得的。 (繼承來源 Selector) |
| SelectedValuePath |
取得或設定用來取得 SelectedItem 屬性 SelectValue 屬性的屬性路徑。 (繼承來源 Selector) |
| SelectionMode |
取得或設定 ListViewBase 實例的選取行為。 (繼承來源 ListViewBase) |
| SemanticZoomOwner |
取得或設定裝載 ListViewBaseSemanticZoom 實例。 (繼承來源 ListViewBase) |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| ShowsScrollingPlaceholders |
取得或設定值，指出檢視是否在卷動期間顯示專案的佔位元 UI。 (繼承來源 ListViewBase) |
| SingleSelectionFollowsFocus |
會獲得或設定一個值，指示當鍵盤焦點改變時，物品選擇是否會改變。 (繼承來源 ListViewBase) |
| Style |
在版面設計和渲染過程中，會取得或設定一個實例樣 式 ，應用於該物件。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定一個值，改變 tab 鍵和 TabIndex 對此控制項的運作方式。 (繼承來源 UIElement) |
| TabIndex |
當使用者使用 Tab 鍵在應用程式介面中導航時，會取得或設定一個值，指示元素獲得焦點的順序。 (繼承來源 Control) |
| TabNavigation |
取得或設定一個值，改變 tab 鍵和 TabIndex 對此控制項的運作方式。 備註 在Windows 10 Creators Update（建置版 10.0.15063）及更新版本中，UIElement 基底類別中可使用 TabFocusNavigation 屬性，以包含不使用 ControlTemplate 的物件。 |
| Tag |
取得或設定一個任意物件值，可用來儲存該物件的自訂資訊。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制範本。 控制範本定義了使用者介面中控制項的視覺外觀，並以 XAML 標記方式定義。 (繼承來源 Control) |
| Transform3D |
在渲染這個元素時，會取得或設定 3D 轉換效果套用。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定轉換矩陣以套用到元素。 (繼承來源 UIElement) |
| Transitions |
取得或設定適用於 UIElement 的 Transition 風格元素集合。 (繼承來源 UIElement) |
| Translation |
取得或設定元素的 x、y 和 z 渲染位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition，用來動畫化 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得為 FrameworkElement 定義的動畫觸發器集合。 不常用。 請參閱備註。 (繼承來源 FrameworkElement) |
| UIContext |
取得該元素的上下文識別碼。 (繼承來源 UIElement) |
| UseLayoutRounding |
取得或設定一個值，決定物件及其視覺子樹的渲染是否應該使用捨入行為，使渲染對齊到整像素。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定一個值，指示控制使用系統繪製的焦點視覺圖，還是控制模板中定義的。 (繼承來源 Control) |
| VerticalAlignment |
取得或設定當 FrameworkElement 被組合在父物件（如面板或項目控制項）時，套用到的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
| Visibility |
取得或設定 UIElement 的可見性。 一個看不到的 UIElement 不會被渲染，也不會向版面傳達其所需的大小。 (繼承來源 UIElement) |
| Width |
取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定 |
| XYFocusDown |
當使用者按下方向鍵（方向鍵）時，會取得或設定該物件被聚焦的目標。 (繼承來源 Control) |
| XYFocusDownNavigationStrategy |
取得或設定一個值，指定用以決定下行導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusKeyboardNavigation |
取得或設定一個值，使鍵盤方向鍵導覽啟用或停用。 (繼承來源 UIElement) |
| XYFocusLeft |
當使用者按下方向鍵（方向鍵）左鍵時，會取得或設定該物件被聚焦。 (繼承來源 Control) |
| XYFocusLeftNavigationStrategy |
取得或設定一個值，指定用來決定左邊導航目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRight |
當使用者右按方向鍵（方向鍵）時，會取得或設定該物件被聚焦。 (繼承來源 Control) |
| XYFocusRightNavigationStrategy |
取得或設定一個值，指定用以決定右向導航目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUp |
當使用者按下方向鍵（方向鍵）向上時，會取得或設定該物件被聚焦。 (繼承來源 Control) |
| XYFocusUpNavigationStrategy |
取得或設定一個值，指定用以決定上行導航目標元素的策略。 (繼承來源 UIElement) |
方法
事件
| 名稱 | Description |
|---|---|
| AccessKeyDisplayDismissed |
當存取鑰匙不再顯示時會發生。 (繼承來源 UIElement) |
| AccessKeyDisplayRequested |
當使用者請求顯示存取金鑰時，會發生這種情況。 (繼承來源 UIElement) |
| AccessKeyInvoked |
當使用者完成一組存取金鑰序列時，會發生這種情況。 (繼承來源 UIElement) |
| ActualThemeChanged |
當 ActualTheme 房產價值變動時，會發生這種情況。 (繼承來源 FrameworkElement) |
| BringIntoViewRequested |
當 StartBringIntoView 被呼叫於此元素或其後代時，會發生此情況。 (繼承來源 UIElement) |
| CharacterReceived |
當輸入佇列接收到單一已組合好字元時，會發生這種情況。 (繼承來源 UIElement) |
| ChoosingGroupHeaderContainer |
發生於要為數據群組選擇專案容器時。 (繼承來源 ListViewBase) |
| ChoosingItemContainer |
發生於要為數據項選擇專案容器時。 (繼承來源 ListViewBase) |
| ContainerContentChanging |
發生於與 UI 容器相關聯的數據項變更時。 (繼承來源 ListViewBase) |
| ContextCanceled |
當上下文輸入手勢繼續進入操作手勢時，會發生，以通知元素不應該開啟上下文飛出。 (繼承來源 UIElement) |
| ContextRequested |
當使用者完成上下文輸入手勢（例如右鍵點擊）時會發生。 (繼承來源 UIElement) |
| DataContextChanged |
當 FrameworkElement.DataContext 屬性的值改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| DoubleTapped |
當未處理的 DoubleTap 互動發生在本元件的命中測試區域時，會發生這種情況。 (繼承來源 UIElement) |
| DragEnter |
當輸入系統回報以該元素為目標的底層拖曳事件時，會發生這種情況。 (繼承來源 UIElement) |
| DragItemsCompleted |
發生於包含檢視中其中一個專案的拖曳作業結束時。 (繼承來源 ListViewBase) |
| DragItemsStarting |
發生於啟動包含檢視中其中一個專案的拖曳作業時。 (繼承來源 ListViewBase) |
| DragLeave |
當輸入系統回報以此元素為原點的底層拖曳事件時，會發生這種情況。 (繼承來源 UIElement) |
| DragOver |
當輸入系統回報一個底層拖曳事件，該元素為潛在的投放目標時發生。 (繼承來源 UIElement) |
| DragStarting |
當啟動拖曳操作時會發生。 (繼承來源 UIElement) |
| Drop |
當輸入系統回報一個底層丟棄事件，並將此元素作為丟棄目標時發生。 (繼承來源 UIElement) |
| DropCompleted |
當以此元素為來源的拖放操作結束時，會發生此現象。 (繼承來源 UIElement) |
| EffectiveViewportChanged |
當 FrameworkElement的有效視口 改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| FocusDisengaged |
當焦點從控制邊界釋放時（用於遊戲手把/遠端互動）。 (繼承來源 Control) |
| FocusEngaged |
當焦點受限於控制範圍（遊戲手把/遠端互動時）會發生。 (繼承來源 Control) |
| GettingFocus |
發生在 UIElement 獲得焦點之前。 這個事件會同步提高，以確保活動在進行時焦點不會被轉移。 (繼承來源 UIElement) |
| GotFocus |
當 UIElement 獲得焦點時會發生。 此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。 (繼承來源 UIElement) |
| Holding |
當本元素的命中測試區域發生原本未處理的 Hold 互動時，會發生這種情況。 (繼承來源 UIElement) |
| IsEnabledChanged |
當 IsEnabled 屬性變更時會發生。 (繼承來源 Control) |
| ItemClick |
當清單檢視中的專案收到互動，且 isItemClickEnabled 屬性 true時發生。 (繼承來源 ListViewBase) |
| KeyDown |
當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。 (繼承來源 UIElement) |
| KeyUp |
當 UIElement 正在對焦時放開鍵盤鍵時會發生。 (繼承來源 UIElement) |
| LayoutUpdated |
當視覺樹的配置改變時，會發生在與佈局相關的屬性改變值或其他會刷新佈局的動作時。 (繼承來源 FrameworkElement) |
| Loaded |
當 FrameworkElement 已被建構並加入物件樹，並準備進行互動時，會發生這種情況。 (繼承來源 FrameworkElement) |
| Loading |
當 FrameworkElement 開始載入時會發生。 (繼承來源 FrameworkElement) |
| LosingFocus |
發生在 UIElement 失去焦點之前。 這個事件會同步提高，以確保活動在進行時焦點不會被轉移。 (繼承來源 UIElement) |
| LostFocus |
當 UIElement 失去焦點時會發生。 此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。 (繼承來源 UIElement) |
| ManipulationCompleted |
當對 UIElement 進行操作完成時，會發生。 (繼承來源 UIElement) |
| ManipulationDelta |
當輸入裝置在操作期間變更位置時發生。 (繼承來源 UIElement) |
| ManipulationInertiaStarting |
當輸入裝置在操作過程中失去與 UIElement 物件的接觸，導致慣性開始時，會發生這種情況。 (繼承來源 UIElement) |
| ManipulationStarted |
當輸入裝置開始對 UIElement 進行操作時，會發生這種情況。 (繼承來源 UIElement) |
| ManipulationStarting |
第一次建立操作處理器時發生。 (繼承來源 UIElement) |
| NoFocusCandidateFound |
當使用者嘗試移動焦點（透過 Tab 鍵或方向箭頭）但焦點無法移動，因為該方向找不到焦點候選時，會發生這種情況。 (繼承來源 UIElement) |
| PointerCanceled |
當一個曾經接觸到的指標異常失去接觸時，就會發生這種情況。 (繼承來源 UIElement) |
| PointerCaptureLost |
當該元素先前持有的指標捕獲移至其他元素或其他位置時，會發生此現象。 (繼承來源 UIElement) |
| PointerEntered |
當指標進入該元素的命中測試區域時發生。 (繼承來源 UIElement) |
| PointerExited |
當指標離開該元素的命中測試區域時，會發生。 (繼承來源 UIElement) |
| PointerMoved |
當指標移動時，指標仍停留在該元素的命中測試區域內。 (繼承來源 UIElement) |
| PointerPressed |
當指標裝置在此元素內啟動 按鍵 動作時，會發生這種情況。 (繼承來源 UIElement) |
| PointerReleased |
當先前發起 新聞 行動的指標裝置在此元素內被釋放時，會發生這種情況。 請注意， Press 行動結束時不保證觸發 PointerReleased 事件;其他事件可能會觸發。 更多資訊請參閱 備註。 (繼承來源 UIElement) |
| PointerWheelChanged |
當指標輪的 delta 值改變時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewKeyDown |
當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。 (繼承來源 UIElement) |
| PreviewKeyUp |
當 UIElement 正在對焦時放開鍵盤鍵時會發生。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
當按下 鍵盤快捷鍵（或加速器） 時會發生。 (繼承來源 UIElement) |
| RightTapped |
當指標正好在元素上方時，右鍵輸入刺激發生。 (繼承來源 UIElement) |
| SelectionChanged |
當目前選擇的項目變更時會發生。 (繼承來源 Selector) |
| SizeChanged |
當 ActualHeight 或 ActualWidth 屬性在 FrameworkElement 上的值改變時，會發生這種情況。 (繼承來源 FrameworkElement) |
| Tapped |
當未處理的 Tap 互動發生在該元件的命中測試區域時。 (繼承來源 UIElement) |
| Unloaded |
當該物件不再連接到主物件樹時，會發生這種情況。 (繼承來源 FrameworkElement) |