Page 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 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 Page : UserControl
[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 Page : UserControl
Public Class Page
Inherits UserControl
<Page .../>
-or-
<Page ...>
singleRootElement
</Page>
- 繼承
- 屬性
範例
以下步驟說明如何為 WinUI 3 專案新增 頁面 ,並導向該頁面。 欲了解更完整的流程,請參閱 「實現兩個頁面間的導航」。
在 Visual Studio 中,從 Blank 應用程式,Packaged(桌面版為 WinUI 3) 專案範本建立一個新的 C# 專案。 從 MainWindow.xaml 和 MainWindow.xaml.cs 檔案中移除範本中包含的範例程式碼。
在專案中新增一個名為 的項目(>空白頁(WinUI
MainPage.xaml3))。接著在
App.xaml.cs中,編輯 OnLaunched 方法覆寫,使其看起來像下面的程式碼。 程式碼顯示應用程式主視窗的內容如何設定為新的 框架,然後導覽到你剛新增的 主頁面 。
protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
m_window = new MainWindow();
// Create a Frame to act as the navigation context.
Frame rootFrame = new Frame();
rootFrame.NavigationFailed += OnNavigationFailed;
// Place the frame in the current Window
m_window.Content = rootFrame;
rootFrame.Navigate(typeof(MainPage), args.Arguments);
m_window.Activate();
}
備註
這個 Page 類別封裝了 Frame 控制可導航到的內容。 你通常會建立由 Page 類別衍生的頁面類型,並使用 Page (或自訂型態)作為 XAML 宣告內容的根元素。 您可以使用 Add | 建立新頁面。Microsoft Visual Studio 中專案的新項目 選單選項。 這會建立一個 XAML 檔案,根節點為 Page 一個帶有 x:Class 屬性 的元素,該屬性連接至 由 Page衍生出的程式碼背後類別。 這個範例展示了一個名為 MainPage的頁面時的樣貌。
<Page
x:Class="App1.MainPage"
... >
...
</Page>
namespace App1
{
public sealed partial class MainPage : Page
{
public MainPage()
{
this.InitializeComponent();
}
}
}
Tip
Visual Studio 包含一個空白頁面範本,你可以用來填充內容。 為了加速應用程式的建立,你可以使用 WinUI 的 Template Studio。 它提供多種應用程式頁面範本,讓你能在新應用程式中加入常見的 UI 頁面,例如清單/詳細資料或網頁檢視等版面配置,或實現應用程式設定等常見模式的頁面。
版面配置
Page是 UserControl,因此你可以宣告一個 XAML 物件元素為 內容。Page 大多數頁面總共包含多個 UI 元素。 你通常會將面板或項目控制項作為 的 Page直接子節點,這樣頁面就能包含並組合多個 UI 元素。 更多資訊請參閱 Layouts with XAML 和 Windows 應用程式輪廓。
導航
建立足夠多的頁面來呈現應用程式中的內容,然後透過呼叫 Frame.Navigate 方法,並傳入頁面的型別參考來導航到這些頁面。 所謂型別參考,是指在你所使用的語言型別系統中識別型態的類別實例。 對於Microsoft .NET,該類型為 System.Type,你可以使用運算符 (C#),從頁面類別名稱取得 typeof 參考。 對於 C++,請使用 TypeName。 更多資訊請參見 TypeName 和 winrt::xaml_typename 函式範本。
透過 Frame.Navigate,你也可以輸入參數物件來初始化頁面到特定狀態。 參數物件的型別較為鬆散,但導覽歷史序列化僅適用於基本型別(參見 Remarks in Frame.Navigate(Type, Object))。 作為啟用一部分被導向的頁面,通常會傳遞啟用時的資料。 其他導覽情境,如搜尋結果頁面,也會預期參數中會包含哪些資訊。
這個例子展示了通話的 Frame.Navigate 樣貌。
rootFrame.Navigate(typeof(MainPage), args.Arguments);
rootFrame.Navigate(xaml_typename<Bookstore::MainPage>(), box_value(e.Arguments()));
預設情況下,每個導覽都會建立一個新請求的實 Page 例(或子類別),並處理前一個 Page 實例。 即使回到先前瀏覽過的頁面,或新頁面類型與前一個頁面類型相同,也會發生這種情況。 需要頻繁瀏覽相同頁面的應用程式,可以快取並重複使用頁面實例,以提升導覽效率。 為此,請設定 Frame.CacheSize 屬性來指定要快取的頁面數量。 對於你想快取的每種頁面類型,你也必須將 NavigationCacheMode 屬性設定為或 EnabledRequired。 具有 Required 快取模式的頁面無論 CacheSize 值如何都會被快取,且不會計入 CacheSize 總數。
你可以覆寫頁面 OnNavigatedTo、 OnNavigatingFrom 和 OnNavigatedFrom 的方法,來執行像是初始化和儲存頁面狀態等任務。 OnNavigatingFrom 可以透過在事件資料中設定 Cancel 屬性來取消導航。
更多資訊請參閱 「實現兩個頁面間的導航」。
建構函式
| 名稱 | Description |
|---|---|
| Page() |
初始化 Page 類別的新實例。 |
屬性
| 名稱 | 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) |
| BottomAppBar |
會取得或設定頁面底部顯示的 AppBar 。 |
| BottomAppBarProperty |
識別 BottomAppBar 依賴屬性。 |
| CacheMode |
取得或設定一個值,表示渲染內容應盡可能以合成點陣圖形式快取。 (繼承來源 UIElement) |
| CanBeScrollAnchor |
取得或設定一個值,指示 UIElement 是否適合作為捲動錨定的候選對象。 (繼承來源 UIElement) |
| CanDrag |
取得或設定一個值,指示該元素是否能以拖放操作的方式被拖曳為資料。 (繼承來源 UIElement) |
| CenterPoint |
取得或設定元素的中心點,即旋轉或縮放發生的中心點。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| CharacterSpacing |
取得或設定字元間的均勻間距,單位為 1/1000 的 em。 (繼承來源 Control) |
| Clip |
取得或設定用於定義 UIElement 內容輪廓的矩形幾何。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定一個屬性,宣告該元素在其父版面配置與視窗中的替代合成與混合模式。 這對於涉及混合 XAML / Microsoft DirectX UI 的元素非常重要。 (繼承來源 UIElement) |
| Content |
取得或設定包含在使用者控制範圍內的內容。 (繼承來源 UserControl) |
| ContextFlyout |
取得或設定與此元素相關的飛出。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定控制點邊界角落的半徑。 (繼承來源 Control) |
| DataContext |
取得或設定 FrameworkElement 的資料上下文。 資料上下文的常見用途是 a |
| DefaultStyleKey |
取得或設定指向該控制項預設風格的鍵。 自訂控制項的作者會利用這個屬性來更改他們控制項所用風格的預設值。 (繼承來源 Control) |
| DefaultStyleResourceUri |
取得或設定包含控制項預設樣式的資源檔案路徑。 (繼承來源 Control) |
| DesiredSize |
取得該 UIElement 在佈局過程的測度通過時計算出的大小。 (繼承來源 UIElement) |
| Dispatcher |
它總是在 Windows 應用程式 SDK 應用程式中回傳 |
| DispatcherQueue |
得到 |
| ElementSoundMode |
取得或設定一個值,指定控制項偏好是否播放聲音。 (繼承來源 Control) |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定一個值,指定在呼叫存取鍵時是否會關閉存取鍵顯示。 (繼承來源 UIElement) |
| FlowDirection |
它設定文字及其他 UI 元素在任何控制其版面配置的父元素內流動的方向。 此屬性可設定為或 |
| FocusState |
會得到一個值,指定此控制是否具備對焦功能,以及取得對焦的方式。 (繼承來源 UIElement) |
| FocusVisualMargin |
取得或設定 FrameworkElement 焦點視覺化的外圍。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定用來繪製框架 |
| FocusVisualPrimaryThickness |
取得或設定框架 |
| FocusVisualSecondaryBrush |
取得或設定用來繪製框架 |
| FocusVisualSecondaryThickness |
取得或設定框架 |
| FontFamily |
取得或設定用於控制項中顯示文字的字型。 (繼承來源 Control) |
| FontSize |
在此控制項中取得或設定文字大小。 (繼承來源 Control) |
| FontStretch |
決定字體在螢幕上的濃縮或擴展程度。 (繼承來源 Control) |
| FontStyle |
取得或設定文字呈現的樣式。 (繼承來源 Control) |
| FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
| Foreground |
取得或設定一筆筆來描述前景色。 (繼承來源 Control) |
| Frame | |
| FrameProperty |
識別 框架 依賴性質。 |
| Height |
取得或設定 FrameworkElement 的建議高度。 (繼承來源 FrameworkElement) |
| HighContrastAdjustment |
取得或設定一個值,指示框架在啟用高對比主題時是否自動調整元素的視覺屬性。 (繼承來源 UIElement) |
| HorizontalAlignment |
取得或設定在 FrameworkElement 組合於版面父元件(如面板或項目控制項)時套用的水平對齊特性。 (繼承來源 FrameworkElement) |
| HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 (繼承來源 Control) |
| IsAccessKeyScope |
取得或設定一個值,指示元素是否定義其存取鍵作用域。 (繼承來源 UIElement) |
| IsDoubleTapEnabled |
取得或設定一個值,決定 DoubleTapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsEnabled |
取得或設定一個值,指示使用者是否能與控制項互動。 (繼承來源 Control) |
| IsFocusEngaged |
設定一個值,表示使用者按下遊戲控制器的 A/Select 鍵時,焦點是否被限制在控制鍵上。 (繼承來源 Control) |
| IsFocusEngagementEnabled |
取得或設定一個值,指示使用者按下遊戲控制器的 A/Select 鍵時,焦點是否能被限制在控制鍵上。 (繼承來源 Control) |
| IsHitTestVisible |
取得或設定此 UIElement 所包含區域是否能回傳真實值以進行命中測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定一個值,決定 持有事件是否 能從該元素產生。 (繼承來源 UIElement) |
| IsLoaded |
會得到一個值,表示該元素是否已被加入元素樹並準備好進行互動。 (繼承來源 FrameworkElement) |
| IsRightTapEnabled |
取得或設定一個值,決定 RightTapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定一個值,指示分頁導覽中是否包含某個控制項。 (繼承來源 UIElement) |
| IsTapEnabled |
取得或設定一個值,決定 Tapped 事件是否能從該元素產生。 (繼承來源 UIElement) |
| IsTextScaleFactorEnabled |
取得或設定是否啟用自動文字放大(反映系統文字大小設定)。 (繼承來源 Control) |
| 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) |
| NavigationCacheMode |
取得或設定導航模式,指示該 頁面 是否被快取,以及快取項目應持續的時間。 |
| 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) |
| RequestedTheme |
取得或設定 UI 主題,該主題由 UIElement (及其子元素)用於資源判定。 你指定的 |
| RequiresPointer |
可設定或設定 UI 元素是否支援滑鼠模式,模擬與非指標輸入裝置(如鍵盤或遊戲控制器)的指標互動體驗。 (繼承來源 Control) |
| Resources |
取得本地定義的資源字典。 在 XAML 中,你可以透過 XAML 隱含的集合語法,將資源項目建立為屬性元素的 |
| Rotation |
設定順時針旋轉的角度,以度數為單位。 相對於旋轉軸和中心點旋轉。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| RotationAxis |
讓軸線旋轉元素。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition,讓 Rotation 屬性的變化動畫化。 (繼承來源 UIElement) |
| Scale |
取得或設定元素的比例。 相對於元素的中心點進行縮放。 會影響元素的渲染位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition,用來動畫化 Scale 屬性的變更。 (繼承來源 UIElement) |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| Style |
在版面設計和渲染過程中,會取得或設定一個實例樣 式 ,應用於該物件。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定一個值,改變 tab 鍵和 TabIndex 對此控制項的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定一個值,決定使用者使用 Tab 鍵在控制項中移動時,元素獲得焦點的順序。 (繼承來源 UIElement) |
| TabNavigation |
取得或設定一個值,改變 Tab 鍵和 UIElement.TabIndex 對此控制項的運作方式。 Note 在Windows 10 Creators Update(建置版 10.0.15063)及更新版本中,UIElement 基底類別中可使用 TabFocusNavigation 屬性,以包含不使用 ControlTemplate 的物件。 |
| Tag |
取得或設定一個任意物件值,可用來儲存該物件的自訂資訊。 (繼承來源 FrameworkElement) |
| Template |
取得或設定控制範本。 控制範本定義了使用者介面中控制項的視覺外觀,並以 XAML 標記方式定義。 (繼承來源 Control) |
| TopAppBar |
在頁面頂端的專用區域顯示 AppBar 或設定。 |
| TopAppBarProperty |
識別 TopAppBar 相依屬性。 |
| Transform3D |
在渲染這個元素時,會取得或設定 3D 轉換效果套用。 (繼承來源 UIElement) |
| TransformMatrix |
取得或設定轉換矩陣以套用到元素。 (繼承來源 UIElement) |
| Transitions |
取得或設定適用於 UIElement 的 Transition 風格元素集合。 (繼承來源 UIElement) |
| Translation |
取得或設定元素的 x、y 和 z 渲染位置。 (繼承來源 UIElement) |
| TranslationTransition |
取得或設定 Vector3Transition,用來動畫化 Translation 屬性的變更。 (繼承來源 UIElement) |
| Triggers |
取得為 FrameworkElement 定義的動畫觸發器集合。 不常用。 請參閱備註。 (繼承來源 FrameworkElement) |
| UseLayoutRounding |
取得或設定一個值,決定物件及其視覺子樹的渲染是否應該使用捨入行為,使渲染對齊到整像素。 (繼承來源 UIElement) |
| UseSystemFocusVisuals |
取得或設定一個值,指示控制使用系統繪製的焦點視覺化,還是控制模板中定義的焦點視覺化。 (繼承來源 UIElement) |
| VerticalAlignment |
取得或設定當 FrameworkElement 被組合在父物件(如面板或項目控制項)時,套用到的垂直對齊特性。 (繼承來源 FrameworkElement) |
| VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
| Visibility |
取得或設定 UIElement 的可見性。 不可見的 A |
| Width |
取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement) |
| XamlRoot |
取得或設定 |
| XYFocusDown |
當使用者按下遊戲控制器的方向鍵(方向鍵)時,會取得或設定該物件被聚焦的目標。 (繼承來源 UIElement) |
| XYFocusDownNavigationStrategy |
取得或設定一個值,指定用以決定下行導覽目標元素的策略。 (繼承來源 UIElement) |
| XYFocusKeyboardNavigation |
取得或設定一個值,使鍵盤方向鍵導覽啟用或停用。 (繼承來源 UIElement) |
| XYFocusLeft |
當使用者按下遊戲控制器方向鍵(D-pad)左鍵時,會取得或設定該物件被聚焦。 (繼承來源 UIElement) |
| XYFocusLeftNavigationStrategy |
取得或設定一個值,指定用來決定左邊導航目標元素的策略。 (繼承來源 UIElement) |
| XYFocusRight |
當使用者按下遊戲控制器方向鍵(方向鍵)時,該物件會被聚焦。 (繼承來源 UIElement) |
| XYFocusRightNavigationStrategy |
取得或設定一個值,指定用以決定右向導航目標元素的策略。 (繼承來源 UIElement) |
| XYFocusUp |
當使用者按下遊戲控制器的方向鍵(D-pad)時,會取得或設定該物件會被聚焦。 (繼承來源 UIElement) |
| XYFocusUpNavigationStrategy |
取得或設定一個值,指定用以決定上行導航目標元素的策略。 (繼承來源 UIElement) |
方法
事件
| 名稱 | Description |
|---|---|
| AccessKeyDisplayDismissed |
當存取鑰匙不再顯示時會發生。 (繼承來源 UIElement) |
| AccessKeyDisplayRequested |
當使用者請求顯示存取金鑰時,會發生這種情況。 (繼承來源 UIElement) |
| AccessKeyInvoked |
當使用者完成一組存取金鑰序列時,會發生這種情況。 (繼承來源 UIElement) |
| ActualThemeChanged |
當 ActualTheme 房產價值變動時,會發生這種情況。 (繼承來源 FrameworkElement) |
| BringIntoViewRequested |
當 StartBringIntoView 被呼叫於此元素或其後代時,會發生此情況。 (繼承來源 UIElement) |
| CharacterReceived |
當輸入佇列接收到單一已組合好字元時,會發生這種情況。 (繼承來源 UIElement) |
| ContextCanceled |
當上下文輸入手勢繼續進入操作手勢時,會發生,以通知元素不應該開啟上下文飛出。 (繼承來源 UIElement) |
| ContextRequested |
當使用者完成上下文輸入手勢(例如右鍵點擊)時會發生。 (繼承來源 UIElement) |
| DataContextChanged |
當 FrameworkElement.DataContext 屬性的值改變時,會發生這種情況。 (繼承來源 FrameworkElement) |
| DoubleTapped |
當未處理的 DoubleTap 互動發生在本元件的命中測試區域時,會發生這種情況。 (繼承來源 UIElement) |
| DragEnter |
當輸入系統回報以該元素為目標的底層拖曳事件時,會發生這種情況。 (繼承來源 UIElement) |
| DragLeave |
當輸入系統回報以此元素為原點的底層拖曳事件時,會發生這種情況。 (繼承來源 UIElement) |
| DragOver |
當輸入系統回報一個底層拖曳事件,該元素為潛在的投放目標時發生。 (繼承來源 UIElement) |
| DragStarting |
當啟動拖曳操作時會發生。 (繼承來源 UIElement) |
| Drop |
當輸入系統回報一個底層丟棄事件,並將此元素作為丟棄目標時發生。 (繼承來源 UIElement) |
| DropCompleted |
當以此元素為來源的拖放操作結束時,會發生此現象。 (繼承來源 UIElement) |
| EffectiveViewportChanged |
當 FrameworkElement的有效視口 改變時,會發生這種情況。 (繼承來源 FrameworkElement) |
| FocusDisengaged |
當使用者按下遊戲控制器的 B/Back 鍵時,控制器上的焦點會被釋放。 (繼承來源 Control) |
| FocusEngaged |
當使用者按下遊戲控制器的 A/Select 鍵時,焦點被限制在控制器上時會發生。 (繼承來源 Control) |
| GettingFocus |
發生在 UIElement 獲得焦點之前。 這個事件會同步提高,以確保活動在進行時焦點不會被轉移。 (繼承來源 UIElement) |
| GotFocus |
當 UIElement 獲得焦點時會發生。 此事件會非同步啟動,因此焦點能在沸騰完成前再次移動。 (繼承來源 UIElement) |
| Holding |
當本元素的命中測試區域發生原本未處理的 Hold 互動時,會發生這種情況。 (繼承來源 UIElement) |
| IsEnabledChanged |
當 IsEnabled 屬性變更時會發生。 (繼承來源 Control) |
| 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 |
當先前發起 新聞 行動的指標裝置在此元素內被釋放時,會發生這種情況。 請注意, 新聞行動 結束時不保證觸發 |
| PointerWheelChanged |
當指標輪的 delta 值改變時,會發生這種情況。 (繼承來源 UIElement) |
| PreviewKeyDown |
當 UIElement 正在對焦時按下鍵盤鍵時,會發生這種情況。 (繼承來源 UIElement) |
| PreviewKeyUp |
當 UIElement 正在對焦時放開鍵盤鍵時會發生。 (繼承來源 UIElement) |
| ProcessKeyboardAccelerators |
當按下 鍵盤快捷鍵(或加速器) 時會發生。 (繼承來源 UIElement) |
| RightTapped |
當指標正好在元素上方時,右鍵輸入刺激發生。 (繼承來源 UIElement) |
| SizeChanged |
當 ActualHeight 或 ActualWidth 屬性在 FrameworkElement 上的值改變時,會發生這種情況。 (繼承來源 FrameworkElement) |
| Tapped |
當未處理的 Tap 互動發生在該元件的命中測試區域時。 (繼承來源 UIElement) |
| Unloaded |
當該物件不再連接到主物件樹時,會發生這種情況。 (繼承來源 FrameworkElement) |