UIElement 類別

定義

命名空間:: Microsoft.UI.Xaml

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

編輯

UIElement 是大多數Windows 執行階段 UI物件的基底類別，這些物件具有視覺外觀，並能將基本輸入納入應用程式的使用者介面。

public ref class UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

/// [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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

[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 UIElement : DependencyObject, IAnimationObject, IVisualElement, IVisualElement2

Public Class UIElement
Inherits DependencyObject
Implements IAnimationObject, IVisualElement, IVisualElement2

繼承: Object Platform::Object IInspectable DependencyObject UIElement

衍生: Microsoft.UI.Xaml.FrameworkElement

屬性: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

實作: IAnimationObject IVisualElement IVisualElement2

備註

UIElement 是一個基礎元素：它是許多其他 Windows 執行階段類別繼承的類別，以支援 XAML 的 UI 元素模型。 UIElement 定義的屬性、方法與事件會被數百個其他 Windows 執行階段類別繼承。

UIElement 不會暴露公共構造器。通常你不會直接從 UIElementFrameworkElement 衍生類別。衍生自訂類別較常使用的基類是下列類別：

未封存的特定控制項（例如 TextBox）
控制基底類別（Control、 ContentControl、 UserControl）
導航元素（頁面、框架）
面板類別（基底類別 Panel，或特定的非密封實作如 Grid）

UIElement 類別被用作 Windows 執行階段 API 中許多屬性與方法的型別參數。例如，邊界的子屬性取UIElement一個單一，代表邊界所圍繞的元素。你可以為這類屬性提供任何 UIElement-衍生元素，包括你定義的自訂控制項。

UIElementCollection 類別提供一個強型別的項目集合UIElement。 UIElementCollection被用作包含多個子元素的物件屬性的型別，例如任何 Panel 類別的 Children 屬性。

UIElement API 與功能

UIElement 擴充了另一個基礎元素 DependencyObject，並新增對多個Windows 執行階段特性領域的支援。

回應用戶互動的輸入和事件

UI 中可見元素的輸入行為大多是在 UIElement 類別中定義的。這包括鍵盤、滑鼠、觸控、拖放和焦點互動的事件。更多資訊請參見「處理指標輸入」、「鍵盤互動」及「自訂使用者互動」。

該系統的知名 API UIElement 支援輸入與使用者互動：

指標事件：PointerPressed、 PointerReleased、 PointerMoved、 PointerEntered、 PointerExited
關鍵處理事件：KeyDown、 KeyUp
專注：有專注，失去專注
指標擷取：CapturePointer、 PointerCanceled、 PointerCaptureLost、 Release PointerCapture、 PointerCaptures
拖放：拖越、拖、拖入、拖離、允許
影響基本輸入處理方式的屬性：IsHitTestVisible、 AllowDrop

手勢和操作

手勢和操作也是處理輸入和用戶互動的方法。 API 會分別列在這裡，因為這些事件代表系統如何與裝置層級的輸入動作互動，並將其解譯為用戶互動。操作是處理動態多點觸控互動的方式，例如捏合和伸展。手勢和操作會一起提供觸控模式來與UWPapp進行觸控互動。更多資訊請參閱自訂使用者互動與觸控互動設計。

其主要 API UIElement 支援手勢與操作：

手勢事件：雙重點擊、保持、右點擊、點擊
操控事件：操控完成、操控Delta、操控慣性開始、操控開始、操控開始
影響手勢與操作處理方式的屬性：IsHoldingEnabled 及其他 Is*Enabled、 ManipulationMode

基本外觀

可見性與不透明度屬性經常用於調整 UI 元素的外觀，特別是在樣式、範本和視覺狀態中。 Clip、RenderTransform 和 Transitions 屬性各自對產生互動和不同外觀的 UI 元素都很有用。

基本佈局

該 UIElement 類別提供版面特性的起點，並以 DesiredSize 及 Arrange 和 Measure 方法等屬性來規劃。 FrameworkElement 新增了更多版面配置功能。更多資訊請參閱「用 XAML 和 FrameworkElement 定義版面」。

路由事件

大多數輸入 UIElement 事件是 路由事件。路由事件會啟用內建事件處理通知系統，讓父物件可以在未處理事件時處理來自物件樹狀結構中子對象的輸入事件。此輸入事件行為適用於輸入區域群組，以及控制組合。如需詳細資訊，請參閱事件與路由事件概觀。

該系統的主要 API UIElement 支援路由事件： AddHandler、 RemoveHandler、*Event properties。

其他平台支援

OnCreateAutomationPeer 讓類別能使用自訂的 AutomationPeer來支援其Microsoft 使用者介面自動化。
RenderTransform、 TransformToVisual、 Projection、 CompositeMode、 CacheMode 及 FindSubElementsForTouchTargeting 對於進階 UI 佈局場景非常有用。

UIElement 相依性屬性

基底元素類別的許多讀寫屬性 UIElement 是相依屬性。相依性屬性支援一些使用 C++ 或 C# 之應用程式的基本程式設計模型功能，例如樣式和範本、數據系結、XAML 資源參考和屬性變更邏輯。欲了解更多相依屬性及其支援的功能，請參閱相依屬性概述。

UIElement 衍生類別

唯一直接源自 UIElement 的 Windows 執行階段類別是 FrameworkElement。關於源自 FrameworkElement 的類別列表，請參閱 FrameworkElement 參考主題中的「FrameworkElement 衍生類別」章節。

屬性

名稱	Description
AccessKey	取得或設定此元素的存取鍵（助記鍵）。
AccessKeyProperty	識別 AccessKey 相依屬性。
AccessKeyScopeOwner	取得或設定一個來源元素，提供該元素的存取鍵作用域，即使該元素不在原始元素的視覺樹中。
AccessKeyScopeOwnerProperty	識別 AccessKeyScopeOwner 相依屬性。
ActualOffset	取得此 UIElement 相對於其父節點的位置，該位置是在佈局流程的排列過程中計算出來的。
ActualSize	取得該 UIElement 在佈局流程安排過程中計算出的大小。
AllowDrop	取得或設定一個值，判斷該 UIElement 是否能作為拖放操作的丟棄目標。
AllowDropProperty	識別 AllowDrop 依賴屬性。
BringIntoViewRequestedEvent	取得 BringIntoViewRequested 路由事件的標識碼。
CacheMode	取得或設定一個值，表示渲染內容應盡可能以合成點陣圖形式快取。
CacheModeProperty	識別 CacheMode 相依屬性。
CanBeScrollAnchor	取得或設定一個值，指示 UIElement 是否適合作為捲動錨定的候選對象。
CanBeScrollAnchorProperty	識別 CanBeScrollAnchor 的相依屬性。
CanDrag	取得或設定一個值，指示該元素是否能以拖放操作的方式被拖曳為資料。
CanDragProperty	識別 CanDrag 依賴性質。
CenterPoint	取得或設定元素的中心點，即旋轉或縮放發生的中心點。會影響元素的渲染位置。
CharacterReceivedEvent	取得 CharacterReceived 路由事件的識別碼。
Clip	取得或設定用於定義 UIElement 內容輪廓的矩形幾何。
ClipProperty	識別 Clip 依賴性屬性。
CompositeMode	取得或設定一個屬性，宣告該元素在其父版面配置與視窗中的替代合成與混合模式。這對於涉及混合 XAML / Microsoft DirectX UI 的元素非常重要。
CompositeModeProperty	識別 CompositeMode 相依屬性。
ContextFlyout	取得或設定與此元素相關的飛出。
ContextFlyoutProperty	識別 ContextFlyout 依賴性屬性。
ContextRequestedEvent	取得 ContextRequested 路由事件的標識碼。
DesiredSize	取得該 UIElement 在佈局過程的測度通過時計算出的大小。
Dispatcher	它總是在 Windows 應用程式 SDK 應用程式中回傳 `null` 。改用 DispatcherQueue 。 (繼承來源 DependencyObject)
DispatcherQueue	得到 `DispatcherQueue` 這個物件所關聯的那個。代表 `DispatcherQueue` 一個功能，即使程式碼是由非 UI 執行緒發起，也能存取 UI `DependencyObject` 執行緒。 (繼承來源 DependencyObject)
DoubleTappedEvent	取得 DoubleTipped 路由事件的識別碼。
DragEnterEvent	取得 DragEnter 路由事件的識別碼。
DragLeaveEvent	取得 DragLeave 路由事件的識別碼。
DragOverEvent	取得 DragOver 路由事件的識別碼。
DropEvent	取得 Drop 路由事件的識別碼。
ExitDisplayModeOnAccessKeyInvoked	取得或設定一個值，指定在呼叫存取鍵時是否會關閉存取鍵顯示。
ExitDisplayModeOnAccessKeyInvokedProperty	識別 ExitDisplayModeOnAccessKeyInvoked 依賴屬性。
FocusState	會得到一個值，指定此控制是否具備對焦功能，以及取得對焦的方式。
FocusStateProperty	識別 FocusState 相依屬性。
GettingFocusEvent	取得 GettingFocus 路由事件的識別碼。
HighContrastAdjustment	取得或設定一個值，指示框架在啟用高對比主題時是否自動調整元素的視覺屬性。
HighContrastAdjustmentProperty	識別 HighContrastAdjustment 的相依屬性。
HoldingEvent	取得持有路由事件的識別碼。
IsAccessKeyScope	取得或設定一個值，指示元素是否定義其存取鍵作用域。
IsAccessKeyScopeProperty	識別 IsAccessKeyScope 依賴屬性。
IsDoubleTapEnabled	取得或設定一個值，決定 DoubleTapped 事件是否能從該元素產生。
IsDoubleTapEnabledProperty	識別 IsDoubleTapEnabled 依賴屬性。
IsHitTestVisible	取得或設定此 UIElement 所包含區域是否能回傳真實值以進行命中測試。
IsHitTestVisibleProperty	識別 IsHitTestVisible 相依屬性。
IsHoldingEnabled	取得或設定一個值，決定持有事件是否能從該元素產生。
IsHoldingEnabledProperty	識別 IsHoldingEnabled 相依屬性。
IsRightTapEnabled	取得或設定一個值，決定 RightTapped 事件是否能從該元素產生。
IsRightTapEnabledProperty	識別 IsRightTapEnabled 相依屬性。
IsTabStop	取得或設定一個值，指示分頁導覽中是否包含某個控制項。
IsTabStopProperty	識別 UIElement.IsTabStop 依賴屬性。
IsTapEnabled	取得或設定一個值，決定 Tapped 事件是否能從該元素產生。
IsTapEnabledProperty	識別 IsTapEnabled 相依屬性。
KeyboardAcceleratorPlacementMode	取得或設定一個值，指示控制工具提示是否顯示其對應鍵盤加速器的按鍵組合。
KeyboardAcceleratorPlacementModeProperty	識別 KeyboardAcceleratorPlacementMode 相依屬性。
KeyboardAcceleratorPlacementTarget	取得或設定一個值，指示顯示加速器按鍵組合的控制工具提示。
KeyboardAcceleratorPlacementTargetProperty	識別 KeyboardAcceleratorPlacementTarget 相依屬性。
KeyboardAccelerators	取得一組按鍵組合，用鍵盤觸發動作。加速器通常分配給按鈕或選單項目。顯示各種選單項目鍵盤加速器的選單範例
KeyDownEvent	取得 KeyDown 路由事件的識別碼。
KeyTipHorizontalOffset	取得或設定一個值，表示鍵尖相對於 UIElement 的位置有多左或多右。
KeyTipHorizontalOffsetProperty	識別 KeyTipHorizontalOffset 依賴屬性。
KeyTipPlacementMode	取得或設定一個值，指示存取鍵提示相對於 UIElement 邊界的位置。
KeyTipPlacementModeProperty	識別 KeyTipPlacementMode 相依屬性。
KeyTipTarget	取得或設定一個值，指示存取鍵提示所鎖定的元素。
KeyTipTargetProperty	識別 KeyTipTarget 相依屬性。
KeyTipVerticalOffset	它會取得或設定一個值，表示鍵尖相對於 UI 元素的上下位置。
KeyTipVerticalOffsetProperty	識別 KeyTipVerticalOffset 依賴屬性。
KeyUpEvent	取得 KeyUp 路由事件的識別碼。
Lights	會讓 XamlLight 物件集合附加到這個元素上。
LightsProperty	識別燈光依賴屬性。
LosingFocusEvent	取得 LosingFocus 路由事件的識別碼。
ManipulationCompletedEvent	取得 ManipulationCompleted 路由事件的識別碼。
ManipulationDeltaEvent	取得 ManipulationDelta 路由事件的識別碼。
ManipulationInertiaStartingEvent	取得 ManipulationInertiaStarting 路由事件的識別碼。
ManipulationMode	取得或設定用於 UIElement 行為及手勢互動的 ManipulationModes 值。設定此值後，能在應用程式程式碼中處理該元素的操作事件。
ManipulationModeProperty	識別 ManipulationMode 相依性質。
ManipulationStartedEvent	取得 ManipulationStarted 路由事件的識別碼。
ManipulationStartingEvent	取得 ManipulationStarting 路由事件的識別碼。
NoFocusCandidateFoundEvent	取得 NoFocusCandidateFound 路由事件的識別碼。
Opacity	取得或設定物件不透明度的度數。
OpacityProperty	識別 IsHitTestVisible 相依屬性。
OpacityTransition	取得或設定 ScalarTransition，用來動畫化 Opacity 屬性的變更。
PointerCanceledEvent	取得 PointerCanceled 路由事件的識別碼。
PointerCaptureLostEvent	取得 PointerCaptureLost 路由事件的識別碼。
PointerCaptures	取得所有捕獲指標的集合，以指標值表示。
PointerCapturesProperty	識別 PointerCaptures 的依賴屬性。
PointerEnteredEvent	取得 PointerEntered 路由事件的識別碼。
PointerExitedEvent	取得 PointerExited 路由事件的識別碼。
PointerMovedEvent	取得 PointerMoved 路由事件的識別碼。
PointerPressedEvent	取得 PointerPressed 路由事件的識別碼。
PointerReleasedEvent	取得 PointerRelease 路由事件的識別碼。
PointerWheelChangedEvent	取得 PointerWheelChanged 路由事件的識別碼。
PreviewKeyDownEvent	取得 PreviewKeyDown 路由事件的標識碼。
PreviewKeyUpEvent	取得 PreviewKeyUp 路由事件的標識碼。
Projection	在渲染這個元素時，會取得或設定投影（3D 效果）來套用。
ProjectionProperty	識別投影依賴性質。
ProtectedCursor	取得或設定游標，當指標位於此元素上時會顯示。預設為 null，表示游標沒有變化。
RasterizationScale	會獲得一個代表額外比例因子的值，用於渲染形狀、影像、文字或媒體，通常是為了渲染比一般解析度更高的解析度。
RenderSize	會取得 UIElement 的最終渲染大小。不建議使用此，詳見備註。
RenderTransform	取得或設定影響 UIElement 渲染位置的轉換資訊。
RenderTransformOrigin	取得或設定 RenderTransform 宣告的任何可能渲染轉換的起點，相對於 UIElement 的界限。
RenderTransformOriginProperty	識別 RenderTransformOrigin 依賴屬性。
RenderTransformProperty	識別 RenderTransform 相依屬性。
RightTappedEvent	取得 RightTipped 路由事件的識別碼。
Rotation	設定順時針旋轉的角度，以度數為單位。相對於旋轉軸和中心點旋轉。會影響元素的渲染位置。
RotationAxis	讓軸線旋轉元素。
RotationTransition	取得或設定 ScalarTransition，讓 Rotation 屬性的變化動畫化。
Scale	取得或設定元素的比例。相對於元素的中心點進行縮放。會影響元素的渲染位置。
ScaleTransition	取得或設定 Vector3Transition，用來動畫化 Scale 屬性的變更。
Shadow	取得或設定元素所轉換的陰影效果。
ShadowProperty	識別影子依賴屬性。
TabFocusNavigation	取得或設定一個值，改變 tab 鍵和 TabIndex 對此控制項的運作方式。
TabFocusNavigationProperty	識別 TabFocusNavigation 相依屬性。
TabIndex	取得或設定一個值，決定使用者使用 Tab 鍵在控制項中移動時，元素獲得焦點的順序。
TabIndexProperty	識別 TabIndex 相依屬性。
TappedEvent	取得 Tapped 路由事件的識別碼。
Transform3D	在渲染這個元素時，會取得或設定 3D 轉換效果套用。
Transform3DProperty	識別 Transform3D 相依屬性。
TransformMatrix	取得或設定轉換矩陣以套用到元素。
Transitions	取得或設定適用於 UIElement 的 Transition 風格元素集合。
TransitionsProperty	識別 Transitions 依賴性質。
Translation	取得或設定元素的 x、y 和 z 渲染位置。
TranslationTransition	取得或設定 Vector3Transition，用來動畫化 Translation 屬性的變更。
UseLayoutRounding	取得或設定一個值，決定物件及其視覺子樹的渲染是否應該使用捨入行為，使渲染對齊到整像素。
UseLayoutRoundingProperty	識別 UseLayoutRound 依賴屬性。
UseSystemFocusVisuals	取得或設定一個值，指示控制使用系統繪製的焦點視覺化，還是控制模板中定義的焦點視覺化。
UseSystemFocusVisualsProperty	識別 UseSystemFocusVisuals 相依屬性。
Visibility	取得或設定 UIElement 的可見性。不可見的 A `UIElement` 不會被渲染，也無法向佈局傳達其期望大小。
VisibilityProperty	識別可見性依賴屬性。
XamlRoot	取得或設定 `XamlRoot` 該元素正在被觀看的區域。
XYFocusDown	當使用者按下遊戲控制器的方向鍵（方向鍵）時，會取得或設定該物件被聚焦的目標。
XYFocusDownNavigationStrategy	取得或設定一個值，指定用以決定下行導覽目標元素的策略。
XYFocusDownNavigationStrategyProperty	識別 XYFocusDownNavigationStrategy 依賴屬性。
XYFocusDownProperty	識別 XYFocusDown 依賴屬性。
XYFocusKeyboardNavigation	取得或設定一個值，使鍵盤方向鍵導覽啟用或停用。
XYFocusKeyboardNavigationProperty	識別 XYFocusKeyboardNavigation 相依屬性。
XYFocusLeft	當使用者按下遊戲控制器方向鍵（D-pad）左鍵時，會取得或設定該物件被聚焦。
XYFocusLeftNavigationStrategy	取得或設定一個值，指定用來決定左邊導航目標元素的策略。
XYFocusLeftNavigationStrategyProperty	識別 XYFocusLeftNavigationStrategy 依賴屬性。
XYFocusLeftProperty	識別 XYFocusLeft 依賴屬性。
XYFocusRight	當使用者按下遊戲控制器方向鍵（方向鍵）時，該物件會被聚焦。
XYFocusRightNavigationStrategy	取得或設定一個值，指定用以決定右向導航目標元素的策略。
XYFocusRightNavigationStrategyProperty	識別 XYFocusRightNavigationStrategy 依賴屬性。
XYFocusRightProperty	識別 XYFocusRight 相依屬性。
XYFocusUp	當使用者按下遊戲控制器的方向鍵（D-pad）時，會取得或設定該物件會被聚焦。
XYFocusUpNavigationStrategy	取得或設定一個值，指定用以決定上行導航目標元素的策略。
XYFocusUpNavigationStrategyProperty	識別 XYFocusUpNavigationStrategy 依賴屬性。
XYFocusUpProperty	識別 XYFocusUp 相依屬性。

方法

名稱	Description
AddHandler(RoutedEvent, Object, Boolean)	為指定的路由事件新增一個路由事件處理器，並將該處理器加入目前元素的處理器集合中。指定`handledEventsTootrue`即使事件在其他地方處理，也能呼叫所提供的處理器。
Arrange(Rect)	定位子物件並決定 UIElement 的大小。為其子元素實作自訂版面配置的父物件，應從其版面覆寫實作中呼叫此方法，形成遞迴版面更新。
CancelDirectManipulations()	取消任何包含當前 UIElement 的 ScrollViewer 父程式上的直接操作處理（系統定義的平移/縮放）。
CapturePointer(Pointer)	將指標擷取設定到 UIElement。一旦被捕獲，只有被捕獲的元素會觸發與指標相關的事件。
ClearValue(DependencyProperty)	清除依賴性財產的局部價值。 (繼承來源 DependencyObject)
FindSubElementsForTouchTargeting(Point, Rect)	啟用 UIElement 子類別，以揭露有助於解決觸控目標的子元素。
Focus(FocusState)	嘗試將焦點設定為這個專案。
GetAnimationBaseValue(DependencyProperty)	回傳任何為相依屬性建立的基礎值，適用於動畫未啟用時。 (繼承來源 DependencyObject)
GetChildrenInTabFocusOrder()	啟用 UIElement 子類別，以暴露參與 Tab 焦點的子元素。
GetValue(DependencyProperty)	回傳 DependencyObject 中相依屬性的當前有效值。 (繼承來源 DependencyObject)
GetVisualInternal()	取回該元素所解析的。`Visual`
InvalidateArrange()	使 UIElement 的 arrange 狀態（layout）失效。失效後， UIElement 的版面會被非同步更新。
InvalidateMeasure()	使 UIElement 的測量狀態（佈局）失效。
Measure(Size)	更新 UIElement 的 DesiredSize 。通常，實作自訂版面版面子版面的物件會從自己的 MeasureOverride 實作中呼叫此方法，形成遞迴版面更新。
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	在 BringIntoViewRequested 事件發生前被呼叫。
OnCreateAutomationPeer()	當在衍生類別中實作時，會回傳類別專屬的 AutomationPeer Microsoft 使用者介面自動化基礎架構的實作。
OnDisconnectVisualChildren()	覆寫此方法，實作當類別特定內容或子屬性移除項目時，版面與邏輯應如何運作。
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	當鍵盤快捷鍵（或加速器）在你的應用程式中處理時會被呼叫。覆寫此方法，以處理應用程式在啟動鍵盤加速器時的回應。
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	在你的應用程式處理鍵盤快捷鍵（或加速器）之前，這會被呼叫。每當應用程式程式碼或內部程序呼叫 ProcessKeyboardAccelators 時會被呼叫。覆寫此方法以影響預設加速器的處理方式。
PopulatePropertyInfo(String, AnimationPropertyInfo)	定義了一個可以被動畫化的屬性。
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	當在派生類別中覆寫時，定義了一個可被動畫化的屬性。
ReadLocalValue(DependencyProperty)	若設定了本地值，則回傳依賴性質的局部值。 (繼承來源 DependencyObject)
RegisterAsScrollPort(UIElement)	將項目註冊為表示可捲動的檢視區。
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	註冊一個通知函式，用於監聽此 DependencyObject 實例中特定 DependencyProperty 的變更。 (繼承來源 DependencyObject)
ReleasePointerCapture(Pointer)	此 UIElement 釋放指標擷取以捕捉特定指標。
ReleasePointerCaptures()	釋放此元素所持有的所有指標捕獲。
RemoveHandler(RoutedEvent, Object)	移除此 UIElement 中指定的路由事件處理程序。通常該處理器是由 AddHandler 新增的。
SetValue(DependencyProperty, Object)	將相依屬性的局部值設定在 DependencyObject 上。 (繼承來源 DependencyObject)
StartAnimation(ICompositionAnimationBase)	開始該元素的指定動畫。
StartBringIntoView()	向 XAML 框架發起請求，要求將元素在任何可捲動的區域內顯示。
StartBringIntoView(BringIntoViewOptions)	會向 XAML 框架發起請求，使用指定的選項將元素帶入視野。
StartDragAsync(ExpPointerPoint)	`UIElement` 是大多數Windows 執行階段 UI物件的基底類別，這些物件具有視覺外觀，並能將基本輸入納入應用程式的使用者介面。
StartDragAsync(PointerPoint)	啟動拖放操作。 Important 若使用者以管理員身份以提升模式執行應用程式，則不支援。
StopAnimation(ICompositionAnimationBase)	停止元素上指定的動畫。
TransformToVisual(UIElement)	回傳一個轉換物件，可用於將座標從 UIElement 轉換到指定物件。
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	嘗試透過搜尋整個 UIElement 視覺樹來呼叫鍵盤捷徑（或加速器）。
TryStartDirectManipulation(Pointer)	恢復對包含當前 UIElement 的任何 ScrollViewer 父節點進行直接操作處理（系統定義的平移/縮放）。
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	取消先前透過呼叫 RegisterPropertyChangedCallback 註冊的變更通知。 (繼承來源 DependencyObject)
UpdateLayout()	確保 UIElement 中所有子物件的位置都正確更新以進行版面配置。

事件

名稱	Description
AccessKeyDisplayDismissed	當存取鑰匙不再顯示時會發生。
AccessKeyDisplayRequested	當使用者請求顯示存取金鑰時，會發生這種情況。
AccessKeyInvoked	當使用者完成一組存取金鑰序列時，會發生這種情況。
BringIntoViewRequested	當 StartBringIntoView 被呼叫於此元素或其後代時，會發生此情況。
CharacterReceived	當輸入佇列接收到單一已組合好字元時，會發生這種情況。
ContextCanceled	當上下文輸入手勢繼續進入操作手勢時，會發生，以通知元素不應該開啟上下文飛出。
ContextRequested	當使用者完成上下文輸入手勢（例如右鍵點擊）時會發生。
DoubleTapped	當未處理的 DoubleTap 互動發生在本元件的命中測試區域時，會發生這種情況。
DragEnter	當輸入系統回報以該元素為目標的底層拖曳事件時，會發生這種情況。
DragLeave	當輸入系統回報以此元素為原點的底層拖曳事件時，會發生這種情況。
DragOver	當輸入系統回報一個底層拖曳事件，該元素為潛在的投放目標時發生。
DragStarting	當啟動拖曳操作時會發生。
Drop	當輸入系統回報一個底層丟棄事件，並將此元素作為丟棄目標時發生。
DropCompleted	當以此元素為來源的拖放操作結束時，會發生此現象。
GettingFocus	發生在 UIElement 獲得焦點之前。這個事件會同步提高，以確保活動在進行時焦點不會被轉移。
GotFocus	當 UIElement 獲得焦點時會發生。此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。
Holding	當本元素的命中測試區域發生原本未處理的 Hold 互動時，會發生這種情況。
KeyDown	當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。
KeyUp	當 UIElement 正在對焦時放開鍵盤鍵時會發生。
LosingFocus	發生在 UIElement 失去焦點之前。這個事件會同步提高，以確保活動在進行時焦點不會被轉移。
LostFocus	當 UIElement 失去焦點時會發生。此事件會非同步啟動，因此焦點能在沸騰完成前再次移動。
ManipulationCompleted	當對 UIElement 進行操作完成時，會發生。
ManipulationDelta	當輸入裝置在操作期間變更位置時發生。
ManipulationInertiaStarting	當輸入裝置在操作過程中失去與 UIElement 物件的接觸，導致慣性開始時，會發生這種情況。
ManipulationStarted	當輸入裝置開始對 UIElement 進行操作時，會發生這種情況。
ManipulationStarting	第一次建立操作處理器時發生。
NoFocusCandidateFound	當使用者嘗試移動焦點（透過 Tab 鍵或方向箭頭）但焦點無法移動，因為該方向找不到焦點候選時，會發生這種情況。
PointerCanceled	當一個曾經接觸到的指標異常失去接觸時，就會發生這種情況。
PointerCaptureLost	當該元素先前持有的指標捕獲移至其他元素或其他位置時，會發生此現象。
PointerEntered	當指標進入該元素的命中測試區域時發生。
PointerExited	當指標離開該元素的命中測試區域時，會發生。
PointerMoved	當指標移動時，指標仍停留在該元素的命中測試區域內。
PointerPressed	當指標裝置在此元素內啟動按鍵動作時，會發生這種情況。
PointerReleased	當先前發起新聞行動的指標裝置在此元素內被釋放時，會發生這種情況。請注意，新聞行動結束時不保證觸發 `PointerReleased` 事件;其他事件可能會觸發。更多資訊請參閱備註。
PointerWheelChanged	當指標輪的 delta 值改變時，會發生這種情況。
PreviewKeyDown	當 UIElement 正在對焦時按下鍵盤鍵時，會發生這種情況。
PreviewKeyUp	當 UIElement 正在對焦時放開鍵盤鍵時會發生。
ProcessKeyboardAccelerators	當按下鍵盤快捷鍵（或加速器）時會發生。
RightTapped	當指標正好在元素上方時，右鍵輸入刺激發生。
Tapped	當未處理的 Tap 互動發生在該元件的命中測試區域時。

適用於

另請參閱

意見反應

此頁面對您有幫助嗎？