GridView 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示在數據列和數據行中顯示數據項的控制件。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GridView : ListViewBase[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class GridView : ListViewBasePublic Class GridView
Inherits ListViewBase<GridView .../>
-or-
<GridView ...>
oneOrMoreItems
</GridView>
- 繼承
-
Object IInspectable DependencyObject UIElement FrameworkElement Control ItemsControl Selector ListViewBase GridView
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例，請參閱 清單檢視和方格檢視。
WinUI 3 資源庫 應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從
Microsoft Store 取得應用程式，或在 GitHub取得原始程式碼。
在這裡，GridView 會系結至名為 cvsProjects的群組 CollectionViewSource。 每個群組中個別項目的外觀是由 ItemTemplate所定義。
ItemsPanel 會指定如何在 GridView 中排列群組。
GroupStyle.Panel 會指定每個群組內的個別項目排列方式。
GroupStyle.ContainerStyle 可用來在每個群組周圍新增框線，並設定其大小和邊界下限。
HidesIfEmpty 屬性會設定為 true true 隱藏任何空白群組。
<Page
x:Class="GroupedGridViewApp.MainPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:local="using:GroupedGridViewApp"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
mc:Ignorable="d"
Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<Page.Resources>
<CollectionViewSource x:Name="cvsProjects" IsSourceGrouped="True"
ItemsPath="Activities"/>
</Page.Resources>
<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<GridView ItemsSource="{Binding Source={StaticResource cvsProjects}}" MaxHeight="500">
<GridView.ItemTemplate>
<DataTemplate>
<StackPanel Margin="20">
<TextBlock Text="{Binding Name}" FontWeight="Bold"
Style="{StaticResource BaseTextBlockStyle}"/>
<TextBlock Text="{Binding DueDate}" TextWrapping="NoWrap"
Style="{StaticResource BodyTextBlockStyle}" />
<CheckBox Content="Complete" IsChecked="{Binding Complete}"
IsEnabled="False"/>
</StackPanel>
</DataTemplate>
</GridView.ItemTemplate>
<GridView.ItemsPanel>
<ItemsPanelTemplate>
<ItemsWrapGrid MaximumRowsOrColumns="3"/>
</ItemsPanelTemplate>
</GridView.ItemsPanel>
<GridView.GroupStyle>
<GroupStyle HidesIfEmpty="True">
<GroupStyle.HeaderTemplate>
<DataTemplate>
<Grid Background="LightGray" Margin="0">
<TextBlock Text='{Binding Name}'
Foreground="Black" Margin="12"
Style="{StaticResource HeaderTextBlockStyle}"/>
</Grid>
</DataTemplate>
</GroupStyle.HeaderTemplate>
</GroupStyle>
</GridView.GroupStyle>
</GridView>
</Page>
using System;
using System.Collections.Generic;
using System.Collections.ObjectModel;
using Windows.UI.Xaml.Controls;
namespace GroupedGridViewApp
{
public sealed partial class MainPage : Page
{
DateTime startDate = DateTime.Now;
public MainPage()
{
this.InitializeComponent();
PopulateProjects();
}
private void PopulateProjects()
{
List<Project> Projects = new List<Project>();
Project newProject = new Project();
newProject.Name = "Project 1";
newProject.Activities.Add(new Activity()
{ Name = "Activity 1", Complete = true, DueDate = startDate.AddDays(4) });
newProject.Activities.Add(new Activity()
{ Name = "Activity 2", Complete = true, DueDate = startDate.AddDays(5) });
Projects.Add(newProject);
newProject = new Project();
newProject.Name = "Project 2";
newProject.Activities.Add(new Activity()
{ Name = "Activity A", Complete = true, DueDate = startDate.AddDays(2) });
newProject.Activities.Add(new Activity()
{ Name = "Activity B", Complete = false, DueDate = startDate.AddDays(3) });
Projects.Add(newProject);
newProject = new Project();
newProject.Name = "Project 3";
Projects.Add(newProject);
cvsProjects.Source = Projects;
}
}
public class Project
{
public Project()
{
Activities = new ObservableCollection<Activity>();
}
public string Name { get; set; }
public ObservableCollection<Activity> Activities { get; private set; }
}
public class Activity
{
public string Name { get; set; }
public DateTime DueDate { get; set; }
public bool Complete { get; set; }
public string Project { get; set; }
}
}
備註
提示
如需詳細資訊、設計指引和程式碼範例，請參閱 清單檢視和方格檢視。
使用 GridView，在可以垂直捲動的數據列和數據行中顯示專案集合。 數據會水準堆疊，直到它填滿數據行為止，然後繼續進行下一個數據列。 當您需要顯示每一個專案的豐富視覺效果時，通常會使用這個視覺效果來取得更多空間，例如相片庫。
GridView 是 ItemsControl，因此它可以包含任何類型的專案集合。 若要填入檢視，請將專案新增至 Items 集合，或將 ItemsSource 屬性設定為數據源。
根據預設，數據項會顯示在 GridView 中，做為系結之數據物件的字串表示。 若要確切指定 GridView 中的項目顯示方式，您可以建立 DataTemplate，以定義用來顯示個別專案的控件配置。 版面配置中的控件可以系結至數據對象的屬性，或內嵌定義內容。 您可以將 DataTemplate 指派給 GridView 的 ItemTemplate 屬性。 如需您可以在應用程式中使用的常見範本，請參閱 gridView
如果您藉由設定 ItemsSource 屬性來填入 GridView，則會將 ItemTemplate 套用至每個專案。 如果您直接填入 Items 集合，只有當專案 不是 gridViewItem時，才會套用 ItemTemplate。 在此範例中，範本會套用至第一個專案，但不會套用第二個專案。
<GridView>
<GridView.ItemTemplate>
<DataTemplate>
<Grid>
<Border Background="LightGray" Height="200" Width="200">
<TextBlock Text="{Binding}"
FontSize="48" Foreground="Green"/>
</Border>
</Grid>
</DataTemplate>
</GridView.ItemTemplate>
<GridView.Items>
<x:String>One</x:String>
<GridViewItem>Two</GridViewItem>
</GridView.Items>
</GridView>
如果您使用 GridView 來顯示大量數據集，請參閱 Optimize ListView 和 GridView，以取得維持順暢且回應式用戶體驗的秘訣。
注意
根據預設，主動式手寫筆會捲動/平移清單（例如觸控、觸控板和被動畫筆）。 如果您的 app 應該使用使用中的手寫筆進行文字選取，您可以覆寫畫筆卷動行為。 如需詳細資訊，請參閱 ScrollViewer 類別參考的 Pen 互動一節。
根據預設，用戶可以在 GridView 中選取單一專案。 您可以將 SelectionMode 屬性設定為 ListViewSelectionMode 列舉值，以允許多重選取或停用選取。 您也可以變更 GridView 互動模式，讓專案像按鈕一樣回應使用者按兩下，而不是被選取。
下表顯示使用者可以與 GridView 互動的方式，以及如何響應互動。
| 若要啟用此互動： | 使用這些設定： | 處理此事件： | 使用此屬性來取得選取的專案： |
|---|---|---|---|
| 沒有互動 | SelectionMode = NoneIsItemClickEnabled = False | N/A | N/A |
| 單一選取 | SelectionMode = SingleIsItemClickEnabled = False | SelectionChanged | SelectedItemSelectedIndex |
| 連續多重選取 | SelectionMode = MultipleIsItemClickEnabled = False | SelectionChanged | SelectedItems |
| 非連續多重選取 | SelectionMode = Extended，IsItemClickEnabled = False | SelectionChanged | SelectedItems |
| 點擊 | SelectionMode = NoneIsItemClickEnabled = True | ItemClick | N/A |
注意
PointerWheelChanged 事件不會從 GridView 升起。 這表示如果指標位於 GridView 上方，則具有 GridView 內的控件不會收到滑鼠滾輪變更訊息。 例如，如果您將 GridView 放在 ScrollViewer內，則當指標位於 GridView 上方時，您無法使用滑鼠滾輪捲動 ScrollViewer。
注意
當您在 GridView 控件上設定 Padding 屬性時，會忽略 右 填補的值;只會套用左、上和下邊框間距的值。
GridView 支援數據虛擬化，以改善大型數據集的效能。 當數據源實作適當的介面時，支援隨機存取虛擬化，視程式設計語言而有所不同：
- Visual C++ 元件延伸模組 （C++/CX） 應用程式應該實作 IObservableVector
。 - C# 或 Visual Basic 應用程式應該實作 INotifyCollectionChanged 和 System.Collections.IList （而不是 IList。 虛擬化需要這兩個介面。 當數據源實作 ISupportIncrementalLoading 介面時，支援累加式載入虛擬化。 支援累加式載入時，您可以使用這些成員來控制數據載入：DataFetchSize、IncrementalLoadingThreshold、IncrementalLoadingTrigger、LoadMoreItemsAsync。
Windows 8 在 Windows 8 中，當選取GridViewItem 中的數據項已取代時，不會清除 SelectedIndex 值。 在Windows 8.1或更新版本中，會清除 SelectedIndex 值。
GridView 會實作 ISemanticZoomInformation 介面，因此它可以做為 SemanticZoom 控件中的檢視。 在 SemanticZoom 控件中使用時，請一律將 ScrollViewer.IsHorizontalScrollChainingEnabled 附加屬性設定為 false gridViewer 控件範本中的 ScrollViewer，如下所示：<GridView ScrollViewer.IsHorizontalScrollChainingEnabled="False">。 只有當 GridView 裝載於
GridView 的預設範本包含現有的轉換動畫。 具體來說，預設 ItemContainerTransitions 值已經包含 addDeleteThemeTransition、ContentThemeTransition、ReorderThemeTransition 和 EntranceThemeTransition 的值（含 IsStaggeringEnabled="False"）。 如果您要在 GridView 上設定 ItemContainerTransitions 的新值，請考慮將這些相同的主題動畫重現為起點。 如果您要自行設定 屬性，除非您在定義中再次包含這些預設值，否則會覆寫這些預設值。
如果您需要在可捲動檢視中處理 UIElement 指標事件（例如 ScrollViewer），您必須呼叫 UIElement.CancelDirectmanipulation（），明確停用檢視中元素的操作事件支援。 若要在檢視中重新啟用操作事件，請呼叫 UIElement.TryStartDirectManipulation。
選取行為和 CollectionViewSource
清單控件衍生自 Selector 具有預設選取行為，取決於專案來源是什麼（用於 ItemsSource的類型）。 如果專案來源是 CollectionViewSource 實例，則選取控件中的行為是選取範圍預設為目前專案。 第一次顯示清單時，選取範圍預設為第一個專案做為目前專案。 如果您不想在此案例中選取第一個專案，請將 IsSynchronizedWithCurrentItem 設定為 GridView 中的 false false。
建構函式
| GridView() |
初始化 GridView 類別的新實例。 |
屬性
| AccessKey |
取得或設定這個項目的訪問鍵（助記鍵）。 (繼承來源 UIElement) |
| AccessKeyScopeOwner |
取得或設定來源專案，提供這個專案的存取鍵範圍，即使它不在來源專案的可視化樹狀結構中也一樣。 (繼承來源 UIElement) |
| ActualHeight |
取得 FrameworkElement的呈現高度。 請參閱。 (繼承來源 FrameworkElement) |
| ActualOffset |
取得這個 UIElement 的位置，相對於其父系，在版面配置程式的排列階段期間計算。 (繼承來源 UIElement) |
| ActualSize |
取得此 UIElement 在版面配置程式的排列階段期間計算的大小。 (繼承來源 UIElement) |
| ActualTheme |
取得專案目前使用的UI主題，該主題可能與 requestedTheme |
| ActualWidth |
取得 FrameworkElement的轉譯寬度。 請參閱。 (繼承來源 FrameworkElement) |
| AllowDrop |
取得或設定值，這個值會決定這個 UIElement 是否可以是拖放作業的置放目標。 (繼承來源 UIElement) |
| AllowFocusOnInteraction |
取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 FrameworkElement) |
| AllowFocusWhenDisabled |
取得或設定停用的控制項是否可以接收焦點。 (繼承來源 FrameworkElement) |
| Background |
取得或設定提供控件背景的筆刷。 (繼承來源 Control) |
| BackgroundSizing |
取得或設定值，這個值表示背景與這個專案框線的關聯程度。 (繼承來源 Control) |
| BaseUri |
取得統一資源識別碼 （URI），代表 XAML 載入時間 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 |
取得或設定 RectangleGeometry，用來定義 UIElement內容的大綱。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定屬性，這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。 (繼承來源 UIElement) |
| ContextFlyout |
取得或設定與這個項目相關聯的飛出視窗。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控件框線角落的半徑。 (繼承來源 Control) |
| DataContext |
取得或設定 FrameworkElement的數據內容。 數據內容的常見用法是當 |
| DataFetchSize |
取得或設定要擷取以虛擬化/預先擷取作業的數據量。 (繼承來源 ListViewBase) |
| DefaultStyleKey |
取得或設定參考控件預設樣式的索引鍵。 自定義控件的作者會使用這個屬性來變更其控件所使用的樣式預設值。 (繼承來源 Control) |
| DefaultStyleResourceUri |
取得或設定包含控制項預設樣式的資源檔案路徑。 (繼承來源 Control) |
| DesiredSize |
取得這個 UIEl ement 在版面配置程式量值階段期間計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
一律會在 Windows App SDK 應用程式中傳回 |
| DispatcherQueue |
取得與這個對象相關聯的 |
| DisplayMemberPath |
取得或設定針對每個數據項顯示之屬性的名稱或路徑。 (繼承來源 ItemsControl) |
| ElementSoundMode |
取得或設定值，指定控件是否播放音效的喜好設定。 (繼承來源 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
| FocusState |
取得值，指定這個控件是否具有焦點，以及取得焦點的模式。 (繼承來源 UIElement) |
| FocusVisualMargin |
取得或設定 FrameworkElement焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualPrimaryThickness |
取得或設定 FrameworkElement之 |
| FocusVisualSecondaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualSecondaryThickness |
取得或設定 FrameworkElement之 |
| 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 |
取得或設定值，指出當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否受限於控件。 (繼承來源 Control) |
| IsFocusEngagementEnabled |
取得或設定值，這個值表示當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點是否受限於控件。 (繼承來源 Control) |
| IsGrouping |
取得值，這個值表示控件是否使用群組。 (繼承來源 ItemsControl) |
| IsHitTestVisible |
取得或設定這個 UIElement 是否可傳回 true 值以進行點擊測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定值，這個值會決定 Holding 事件是否源自該專案。 (繼承來源 UIElement) |
| IsItemClickEnabled |
取得或設定值，指出檢視中的專案是否引發 ItemClick 事件，以響應互動。 (繼承來源 ListViewBase) |
| IsLoaded |
取得值，這個值表示專案是否已新增至專案樹狀結構，並且已準備好進行互動。 (繼承來源 FrameworkElement) |
| IsMultiSelectCheckBoxEnabled |
取得或設定值，這個值表示是否顯示複選框來啟用多重選取。 (繼承來源 ListViewBase) |
| IsRightTapEnabled |
取得或設定值，這個值會決定 rightTapped 事件是否源自該專案。 (繼承來源 UIElement) |
| IsSwipeEnabled |
取得或設定值，這個值表示檢視是否支援 撥動 互動的離散輸入處理。 (繼承來源 ListViewBase) |
| IsSynchronizedWithCurrentItem |
取得或設定值，這個值表示 |
| IsTabStop |
取得或設定值，指出控件是否包含在索引標籤導覽中。 (繼承來源 UIElement) |
| IsTapEnabled |
取得或設定值，這個值會決定點選 事件 |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動文字放大，以反映系統文字大小設定。 (繼承來源 Control) |
| IsZoomedInView |
取得或設定值，這個值表示 ListViewBase 實例是否為其擁有 SemanticZoom中的縮放檢視。 (繼承來源 ListViewBase) |
| ItemContainerGenerator |
取得與此 ItemsControl相關聯的 ItemContainerGenerator。 (繼承來源 ItemsControl) |
| ItemContainerStyle |
取得或設定在呈現 ItemsControl之專案容器時所使用的樣式。 (繼承來源 ItemsControl) |
| ItemContainerStyleSelector |
取得或設定自定義 StyleSelector 邏輯類別的參考。 StyleSelector 會根據所顯示物件的特性，傳回不同的 Style 值。 (繼承來源 ItemsControl) |
| ItemContainerTransitions |
取得或設定套用至 itemsControl |
| Items |
取得用來產生控件內容的集合。 (繼承來源 ItemsControl) |
| ItemsPanel |
取得或設定範本，這個範本會定義控制專案配置的面板。 (繼承來源 ItemsControl) |
| ItemsPanelRoot |
取得 ItemsPanel所指定的 Panel。 (繼承來源 ItemsControl) |
| ItemsSource |
取得或設定物件來源，用來產生 ItemsControl的內容。 (繼承來源 ItemsControl) |
| ItemTemplate |
取得或設定用來顯示每個專案的 DataTemplate。 (繼承來源 ItemsControl) |
| ItemTemplateSelector |
取得或設定自定義 DataTemplateSelector 邏輯類別的參考。 此屬性所參考 DataTemplateSelector 會傳回要套用至專案的範本。 (繼承來源 ItemsControl) |
| KeyboardAcceleratorPlacementMode |
取得或設定值，這個值表示控件是否 工具提示 顯示其相關聯鍵盤快捷方式的按鍵組合。 (繼承來源 UIElement) |
| KeyboardAcceleratorPlacementTarget |
取得或設定值，這個值表示顯示快速鍵組合的控件 工具提示。 (繼承來源 UIElement) |
| KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快捷鍵通常會指派給按鈕或功能表項。
|
| KeyTipHorizontalOffset |
取得或設定值，這個值表示索引鍵提示相對於UIElement放置的左邊或右邊。 (繼承來源 UIElement) |
| KeyTipPlacementMode |
取得或設定值，這個值表示存取密鑰提示相對於 UIElement 界限的位置。 (繼承來源 UIElement) |
| KeyTipTarget |
取得或設定值，這個值表示以訪問鍵提示為目標的專案。 (繼承來源 UIElement) |
| KeyTipVerticalOffset |
取得或設定值，這個值表示索引鍵提示相對於UI元素的上移或下移。 (繼承來源 UIElement) |
| Language |
取得或設定適用於 FrameworkElement的當地語系化/全球化語言資訊，以及套用至物件表示法和 UI 中目前 FrameworkEl ement 的所有子元素。 (繼承來源 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) |
| ProtectedCursor |
取得或設定指標位於這個專案上方時所顯示的游標。 默認值為 null，表示數據指標沒有變更。 (繼承來源 UIElement) |
| RasterizationScale |
取得值，表示每個檢視圖元的原始（實體）像素數目。 (繼承來源 UIElement) |
| RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用，請參閱。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點，相對於 UIElement界限。 (繼承來源 UIElement) |
| ReorderMode |
取得或設定 ListViewBase 實例的重新排序行為。 啟用時，使用者操作可以重新排序未排序和未分組的清單。 (繼承來源 ListViewBase) |
| RequestedTheme |
取得或設定 UIElement 及其子元素用於資源判斷的 UI 主題。 您使用 |
| RequiresPointer |
取得或設定UI元素是否支援滑鼠模式，以模擬指標互動體驗與非指標輸入設備，例如鍵盤或遊戲控制器。 (繼承來源 Control) |
| Resources |
取得本機定義的資源字典。 在 XAML 中，您可以透過 XAML 隱含集合語法，將資源專案建立為 |
| Rotation |
取得或設定順時針旋轉的角度，以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| RotationAxis |
取得或設定要繞著元素旋轉的座標軸。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
| Scale |
取得或設定項目的縮放比例。 相對於專案的 CenterPoint 縮放比例。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
| SelectedIndex |
取得或設定所選取專案的索引。 (繼承來源 Selector) |
| SelectedItem |
取得或設定選取的專案。 (繼承來源 Selector) |
| SelectedItems |
取得目前選取的專案。 (繼承來源 ListViewBase) |
| SelectedRanges |
取得 ItemIndexRange 物件集合，這些物件描述清單中目前選取的專案。 (繼承來源 ListViewBase) |
| SelectedValue |
取得或設定選取專案的值，使用 SelectedValuePath取得。 (繼承來源 Selector) |
| SelectedValuePath |
取得或設定用來取得 SelectedItem SelectedItem 屬性之 SelectedValue 屬性的屬性路徑。 (繼承來源 Selector) |
| SelectionMode |
取得或設定 ListViewBase 實例的選取行為。 (繼承來源 ListViewBase) |
| SemanticZoomOwner |
取得或設定裝載 ListViewBaseSemanticZoom 實例。 (繼承來源 ListViewBase) |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| ShowsScrollingPlaceholders |
取得或設定值，指出檢視是否在卷動期間顯示專案的佔位元 UI。 (繼承來源 ListViewBase) |
| SingleSelectionFollowsFocus |
取得或設定值，這個值表示當鍵盤焦點變更時，項目選取範圍是否變更。 (繼承來源 ListViewBase) |
| Style |
取得或設定在版面配置和轉譯期間套用給這個對象的實例 Style。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定值，這個值會修改Tabbing和 TabIndex 此控件的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，這個值會決定當使用者使用 索引卷標 索引鍵巡覽控件時，專案接收焦點的順序。 (繼承來源 UIElement) |
| TabNavigation |
取得或設定值，這個值會修改Tabbing和 UIElement.TabIndex 此控件的運作方式。 注意 針對 Windows 10 Creators Update（組建 10.0.15063）和更新版本，TabFocusNavigation 屬性可在 UIElement 基類上使用，以在不使用 controlTemplate的索引卷標序列中包含物件。 |
| Tag |
取得或設定可用來儲存這個物件之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控件範本。 控件範本會定義 UI 中控制件的視覺外觀，並在 XAML 標記中定義。 (繼承來源 Control) |
| Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定要套用至 項目的轉換矩陣。 (繼承來源 UIElement) |
| Transitions |
取得或設定套用至 UIElement之轉換 樣式專案的集合。 (繼承來源 UIElement) |
| Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition，以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得為 FrameworkElement定義的動畫觸發程式集合。 不常使用。 請參閱。 (繼承來源 FrameworkElement) |
| UseLayoutRounding |
取得或設定值，這個值會決定物件及其視覺子樹的轉譯是否應該使用將轉譯對齊整個圖元的四捨五入行為。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定值，這個值表示控件是否使用系統所繪製的焦點視覺效果，或是控件範本中定義的焦點視覺效果。 (繼承來源 UIElement) |
| VerticalAlignment |
取得或設定在面板或專案控件等父對象中組成時，套用至 FrameworkElement 的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控件內容的垂直對齊方式。 (繼承來源 Control) |
| Visibility |
取得或設定 UIElement的可見性。 不會轉譯不可見的 |
| Width |
取得或設定 FrameworkElement的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定檢視這個專案 |
| XYFocusDown |
取得或設定當使用者按下遊戲控制器之 Directional Pad （D-pad） 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusDownNavigationStrategy |
取得或設定值，指定用來判斷向下瀏覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusKeyboardNavigation |
取得或設定值，這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
| XYFocusLeft |
取得或設定當使用者在遊戲控制器的 Directional Pad （D-pad） 上按左鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusLeftNavigationStrategy |
取得或設定值，指定用來判斷左側導覽之目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRight |
取得或設定當使用者在遊戲控制器的 Directional Pad （D-pad） 上按下滑鼠右鍵時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusRightNavigationStrategy |
取得或設定值，指定用來判斷右導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUp |
取得或設定當使用者按下遊戲控制器之 Directional Pad （D-pad） 時取得焦點的物件。 (繼承來源 UIElement) |
| XYFocusUpNavigationStrategy |
取得或設定值，指定用來判斷向上瀏覽目標元素的策略。 (繼承來源 UIElement) |
方法
事件
| 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 |
當使用者按下遊戲控制器上的 [B/上一頁] 按鈕時，會從控件釋放焦點時發生。 (繼承來源 Control) |
| FocusEngaged |
當使用者按下遊戲控制器上的 A/Select 按鈕時，焦點會限制為控件。 (繼承來源 Control) |
| GettingFocus |
發生於 UIElement 收到焦點之前。 此事件會以同步方式引發，以確保事件發生反升時不會移動焦點。 (繼承來源 UIElement) |
| GotFocus |
發生於 UIElement 收到焦點時。 這個事件會以異步方式引發，因此焦點可以在升泡完成之前再次移動。 (繼承來源 UIElement) |
| Holding |
發生於未處理的 保留 互動發生在這個項目的點擊測試區域時。 (繼承來源 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 |
發生於使用者嘗試移動焦點時（透過定位鍵或方向箭號），但焦點不會移動，因為移動方向找不到任何焦點候選專案。 (繼承來源 UIElement) |
| PointerCanceled |
發生於使聯繫人異常失去聯繫人的指標時。 (繼承來源 UIElement) |
| PointerCaptureLost |
當這個專案先前持有的指標擷取移至另一個專案或其他地方時發生。 (繼承來源 UIElement) |
| PointerEntered |
當指標進入這個項目的點擊測試區域時發生。 (繼承來源 UIElement) |
| PointerExited |
發生於指標離開這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| PointerMoved |
發生於指標在指標保留在這個專案點擊測試區域內時移動。 (繼承來源 UIElement) |
| PointerPressed |
當指標裝置起始此元素內的 Press 動作時發生。 (繼承來源 UIElement) |
| PointerReleased |
發生於先前起始 Press 動作的指標裝置，同時在此元素內。 請注意，Press 動作的結尾不保證會引發 |
| PointerWheelChanged |
發生於指標滾輪的差異值變更時。 (繼承來源 UIElement) |
| PreviewKeyDown |
發生於按下鍵盤按鍵時，UIElement 有焦點時。 (繼承來源 UIElement) |
| PreviewKeyUp |
當 UIElement 焦點時放開鍵盤按鍵時發生。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
發生於按下 鍵盤快捷方式（或快捷鍵） 時。 (繼承來源 UIElement) |
| RightTapped |
當指標位於 元素上方時發生右鍵輸入刺激時發生。 (繼承來源 UIElement) |
| SelectionChanged |
發生於目前選取的項目變更時。 (繼承來源 Selector) |
| SizeChanged |
發生於 ActualHeight 或 ActualWidth 屬性值變更 FrameworkElement時。 (繼承來源 FrameworkElement) |
| Tapped |
發生於未處理的 Tap 互動發生在這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| Unloaded |
當這個物件不再連接到主要物件樹狀結構時發生。 (繼承來源 FrameworkElement) |