RelativePanel 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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 RelativePanel : Panel[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 RelativePanel : PanelPublic Class RelativePanel
Inherits Panel<RelativePanel ...>
oneOrMoreUIElements
</RelativePanel>
-or-
<RelativePanel .../>
- 繼承
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例，請參閱
WinUI 3 資源庫 應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從
Microsoft Store 取得應用程式，或在 GitHub取得原始程式碼。
備註
RelativePanel 是一種配置容器，可用於建立沒有清楚線性模式的 UI;也就是說，不是基本堆疊、包裝或表格式的配置，您可以在其中自然使用 StackPanel 或 Grid。
如果您的UI是由多個巢狀面板所組成，RelativePanel 是考慮的好選項。
以下是 UI 在其版面配置中使用 RelativePanel 的範例：
<RelativePanel BorderBrush="Gray" BorderThickness="10">
<Rectangle x:Name="RedRect" Fill="Red" MinHeight="100" MinWidth="100"/>
<Rectangle x:Name="BlueRect" Fill="Blue" MinHeight="100" MinWidth="100"
RelativePanel.RightOf="RedRect"/>
<!-- Width is not set on the green and yellow rectangles.
It's determined by the RelativePanel properties. -->
<Rectangle x:Name="GreenRect" Fill="Green" MinHeight="100" Margin="0,5,0,0"
RelativePanel.Below="RedRect"
RelativePanel.AlignLeftWith="RedRect"
RelativePanel.AlignRightWith="BlueRect"/>
<Rectangle Fill="Yellow" MinHeight="100"
RelativePanel.Below="GreenRect"
RelativePanel.AlignLeftWith="BlueRect"
RelativePanel.AlignRightWithPanel="True"/>
</RelativePanel>
RelativePanel 可與 AdaptiveTrigger 搭配使用，是一個功能強大的工具，可建立可跨不同螢幕大小調整良好的回應式 UI。 如需更多範例，請參閱
預設位置
根據預設，宣告為 RelativePanel 子系的任何未限制專案會得到整個可用空間，並放置在面板的 （0， 0） 座標 （左上角） 位置。 因此，如果您要將第二個元素置於相對於不受限制的元素，請記住，第二個元素可能會從面板推出。
在此範例中，RectA 沒有任何條件約束，因此其定位在 （0,0）。
RectB 不會顯示在畫面上，因為它宣告為 上方RectA，因此會推送出面板。
<RelativePanel>
<Rectangle Name="RectA" Fill="Red" Height="40" Width="40"/>
<Rectangle Name="RectB" Fill="Blue" Height="40" Width="40"
RelativePanel.Above="RectA"/>
</RelativePanel>
迴圈相依性
當 RelativePanel 內的兩個元素以任何方向宣告彼此的關聯性時，就會發生迴圈相依性。 例如，此 XAML 會導致設計時間例外狀況：「RelativePanel 錯誤：偵測到迴圈相依性。 版面配置無法完成。
<RelativePanel>
<Rectangle Name="RectA" Fill="Red" Height="40" Width="40"
RelativePanel.Above="RectB"/>
<Rectangle Name="RectB" Fill="Blue" Height="40" Width="40"
RelativePanel.Below="RectA"/>
</RelativePanel>
衝突關聯性
如果您設定多個以元素相同邊緣為目標的關聯性，則您的版面配置中可能會有衝突的關聯性。 發生這種情況時，會以下列優先順序套用關聯性：
- 面板對齊關聯性 （AlignTopWithPanel、AlignLeftWithPanel...） 會先套用。
- 同層級對齊關聯性 （AlignTopWith、AlignLeftWith...） 會套用第二個。
- 同層級位置關聯性（上方、下方、RightOf、LeftOf）最後套用。
面板中心對齊屬性（AlignVerticalCenterWith、AlignHorizontalCenterWithPanel...） 通常獨立於其他條件約束之外使用，而且在沒有衝突時套用。
在評估及套用關聯性屬性之後，會套用 UI 元素上的 HorizontalAlignment 和 VerticalAlignment 屬性。 如果所需的大小小於可用大小，這些屬性會控制元素在可用大小內的位置。
框線屬性
RelativePanel 定義框線屬性，可讓您在 RelativePanel 周圍繪製框線，而不需使用額外的 Border 元素。 屬性 RelativePanel.BorderBrush、RelativePanel.BorderThickness、RelativePanel.CornerRadius，RelativePanel.Padding。
<RelativePanel BorderBrush="Red" BorderThickness="2" CornerRadius="10" Padding="12">
<TextBox x:Name="textBox1" RelativePanel.AlignLeftWithPanel="True"/>
<Button Content="Submit" RelativePanel.Below="textBox1"/>
</RelativePanel>
XAML 附加屬性
RelativePanel 是數個 XAML 附加屬性的主機服務類別，。
為了支援 XAML 處理器存取附加屬性，而且為了公開對等 取得，並將 設定為程式代碼 作業，每個 XAML 附加屬性都有一對 Get 和 Set 存取子方法。 在程序代碼中取得或設定值的另一種方法是使用相依性屬性系統，呼叫 GetValue 或 SetValue，並將標識符欄位傳遞為相依性屬性標識符。
| 附加屬性 | 描述 |
|---|---|
| 以上 | 取得或設定這個項目位於上方的目標專案。
|
| AlignBottomWith | 取得或設定這個專案的下邊緣對齊的目標專案。
|
| AlignBottomWithPanel | 取得或設定值，這個值表示這個專案的下邊緣是否觸碰面板的下邊緣。
|
| AlignHorizontalCenterWith | 取得或設定這個項目的水準置中對齊的目標專案。 |
| AlignHorizontalCenterWithPanel | 取得或設定值，這個值表示這個專案的水準軸是否觸碰面板的水平軸。 |
| AlignLeftWith | 取得或設定這個專案左邊緣所對齊的目標專案。
|
| AlignLeftWithPanel | 取得或設定值，這個值表示這個專案的左邊緣是否觸碰面板的左邊緣。
|
| AlignRightWith | 取得或設定這個專案右邊緣所對齊的目標專案。
|
| AlignRightWithPanel | 取得或設定值，這個值表示這個專案的右邊緣是否觸碰面板的右邊緣。
|
| AlignTopWith | 取得或設定這個項目上邊緣對齊的目標專案。
|
| AlignTopWithPanel | 取得或設定值，這個值表示這個專案的上邊緣是否觸碰面板的上邊緣。
|
| AlignVerticalCenterWith | 取得或設定這個專案垂直置中對齊的目標專案。 |
| AlignVerticalCenterWithPanel | 取得或設定值，這個值表示這個專案的垂直軸是否觸及面板的水準軸。 |
| 下面 | 取得或設定這個項目位於下方的目標專案。
|
| LeftOf | 取得或設定這個項目位於 左邊的目標專案。
|
| RightOf | 取得或設定這個項目位於 右邊的目標專案。
|
建構函式
| RelativePanel() |
初始化 RelativePanel 類別的新實例。 |
屬性
| AboveProperty |
識別 RelativePanel.Above XAML 附加屬性。 |
| AccessKey |
取得或設定這個項目的訪問鍵（助記鍵）。 (繼承來源 UIElement) |
| AccessKeyScopeOwner |
取得或設定來源專案，提供這個專案的存取鍵範圍，即使它不在來源專案的可視化樹狀結構中也一樣。 (繼承來源 UIElement) |
| ActualHeight |
取得 FrameworkElement的呈現高度。 請參閱。 (繼承來源 FrameworkElement) |
| ActualOffset |
取得這個 UIElement 的位置，相對於其父系，在版面配置程式的排列階段期間計算。 (繼承來源 UIElement) |
| ActualSize |
取得此 UIElement 在版面配置程式的排列階段期間計算的大小。 (繼承來源 UIElement) |
| ActualTheme |
取得專案目前使用的UI主題，該主題可能與 requestedTheme |
| ActualWidth |
取得 FrameworkElement的轉譯寬度。 請參閱。 (繼承來源 FrameworkElement) |
| AlignBottomWithPanelProperty |
識別 RelativePanel.AlignBottomWithPanel XAML 附加屬性。 |
| AlignBottomWithProperty |
識別 RelativePanel.AlignBottomWith XAML 附加屬性。 |
| AlignHorizontalCenterWithPanelProperty |
識別 RelativePanel.AlignHorizontalCenterWithPanel XAML 附加屬性。 |
| AlignHorizontalCenterWithProperty |
取得目標元素 RelativePanel.AlignHorizontalCenterWith XAML 附加屬性的值。 |
| AlignLeftWithPanelProperty |
識別 RelativePanel.AlignLeftWithPanel XAML 附加屬性。 |
| AlignLeftWithProperty |
識別 RelativePanel.AlignLeftWith XAML 附加屬性。 |
| AlignRightWithPanelProperty |
識別 RelativePanel.AlignRightWithPanel XAML 附加屬性。 |
| AlignRightWithProperty |
識別 RelativePanel.AlignRightWith XAML 附加屬性。 |
| AlignTopWithPanelProperty |
識別 RelativePanel.AlignTopWithPanel XAML 附加屬性。 |
| AlignTopWithProperty |
識別 RelativePanel.AlignTopWith XAML 附加屬性。 |
| AlignVerticalCenterWithPanelProperty |
識別 RelativePanel.AlignVerticalCenterWithPanel XAML 附加屬性。 |
| AlignVerticalCenterWithProperty |
取得目標元素 RelativePanel.AlignVerticalCenterWith XAML 附加屬性的值。 |
| AllowDrop |
取得或設定值，這個值會決定這個 UIElement 是否可以是拖放作業的置放目標。 (繼承來源 UIElement) |
| AllowFocusOnInteraction |
取得或設定值，這個值表示當使用者與其互動時，專案是否會自動取得焦點。 (繼承來源 FrameworkElement) |
| AllowFocusWhenDisabled |
取得或設定停用的控制項是否可以接收焦點。 (繼承來源 FrameworkElement) |
| Background |
取得或設定填滿面板內容區域的 Brush。 (繼承來源 Panel) |
| BackgroundSizing |
取得或設定值，這個值表示背景與這個專案框線的關聯程度。 |
| BackgroundSizingProperty |
識別 BackgroundSizing 相依性屬性。 |
| BackgroundTransition |
取得或設定 BrushTransition 的實例，以自動建立 Background 屬性變更的動畫效果。 (繼承來源 Panel) |
| BaseUri |
取得統一資源識別碼 （URI），代表 XAML 載入時間 XAML 建構物件的基底 URI。 這個屬性適用於運行時間的 URI 解析。 (繼承來源 FrameworkElement) |
| BelowProperty |
識別 RelativePanel.Below XAML 附加屬性。 |
| BorderBrush |
取得或設定描述面板框線填滿的筆刷。 |
| BorderBrushProperty |
識別 BorderBrush 相依性屬性。 |
| BorderThickness |
取得或設定面板的框線粗細。 |
| BorderThicknessProperty |
識別 BorderThickness 相依性屬性。 |
| CacheMode |
取得或設定值，這個值表示轉譯的內容應該盡可能快取為複合位圖。 (繼承來源 UIElement) |
| CanBeScrollAnchor |
取得或設定值，這個值表示 UIElement 是否為卷動錨定候選專案。 (繼承來源 UIElement) |
| CanDrag |
取得或設定值，這個值表示專案是否可以拖曳為拖放作業中的數據。 (繼承來源 UIElement) |
| CenterPoint |
取得或設定專案的中心點，也就是發生旋轉或縮放的點。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| Children |
取得面板子專案的集合。 (繼承來源 Panel) |
| ChildrenTransitions |
取得或設定套用至 Panel 子類別之子內容的 Transition 樣式專案集合。 (繼承來源 Panel) |
| Clip |
取得或設定 RectangleGeometry，用來定義 UIElement內容的大綱。 (繼承來源 UIElement) |
| CompositeMode |
取得或設定屬性，這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。 (繼承來源 UIElement) |
| ContextFlyout |
取得或設定與這個項目相關聯的飛出視窗。 (繼承來源 UIElement) |
| CornerRadius |
取得或設定面板框線角落的半徑。 |
| CornerRadiusProperty |
識別 CornerRadius 相依性屬性。 |
| DataContext |
取得或設定 FrameworkElement的數據內容。 數據內容的常見用法是當 |
| DesiredSize |
取得這個 UIEl ement 在版面配置程式量值階段期間計算的大小。 (繼承來源 UIElement) |
| Dispatcher |
一律會在 Windows App SDK 應用程式中傳回 |
| DispatcherQueue |
取得與這個對象相關聯的 |
| ExitDisplayModeOnAccessKeyInvoked |
取得或設定值，指定叫用存取金鑰時是否關閉存取金鑰顯示。 (繼承來源 UIElement) |
| FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
| FocusState |
取得值，指定這個控件是否具有焦點，以及取得焦點的模式。 (繼承來源 UIElement) |
| FocusVisualMargin |
取得或設定 FrameworkElement焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
| FocusVisualPrimaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualPrimaryThickness |
取得或設定 FrameworkElement之 |
| FocusVisualSecondaryBrush |
取得或設定筆刷，用來繪製 |
| FocusVisualSecondaryThickness |
取得或設定 FrameworkElement之 |
| Height |
取得或設定 FrameworkElement的建議高度。 (繼承來源 FrameworkElement) |
| HighContrastAdjustment |
取得或設定值，這個值表示當啟用高對比度主題時，架構是否會自動調整專案的視覺屬性。 (繼承來源 UIElement) |
| HorizontalAlignment |
取得或設定在版面配置父系中組成時，套用至 FrameworkElement 的水準對齊特性，例如面板或專案控件。 (繼承來源 FrameworkElement) |
| IsAccessKeyScope |
取得或設定值，這個值表示專案是否定義自己的訪問鍵範圍。 (繼承來源 UIElement) |
| IsDoubleTapEnabled |
取得或設定值，這個值會決定 DoubleTapped 事件是否源自該專案。 (繼承來源 UIElement) |
| IsHitTestVisible |
取得或設定這個 UIElement 是否可傳回 true 值以進行點擊測試。 (繼承來源 UIElement) |
| IsHoldingEnabled |
取得或設定值，這個值會決定 Holding 事件是否源自該專案。 (繼承來源 UIElement) |
| IsItemsHost |
取得值，這個值表示這個 Panel 是否為由 ItemsControl所產生的 UI 專案的容器。 (繼承來源 Panel) |
| IsLoaded |
取得值，這個值表示專案是否已新增至專案樹狀結構，並且已準備好進行互動。 (繼承來源 FrameworkElement) |
| IsRightTapEnabled |
取得或設定值，這個值會決定 rightTapped 事件是否源自該專案。 (繼承來源 UIElement) |
| IsTabStop |
取得或設定值，指出控件是否包含在索引標籤導覽中。 (繼承來源 UIElement) |
| IsTapEnabled |
取得或設定值，這個值會決定點選 事件 |
| KeyboardAcceleratorPlacementMode |
取得或設定值，這個值表示控件是否 工具提示 顯示其相關聯鍵盤快捷方式的按鍵組合。 (繼承來源 UIElement) |
| KeyboardAcceleratorPlacementTarget |
取得或設定值，這個值表示顯示快速鍵組合的控件 工具提示。 (繼承來源 UIElement) |
| KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快捷鍵通常會指派給按鈕或功能表項。
|
| KeyTipHorizontalOffset |
取得或設定值，這個值表示索引鍵提示相對於UIElement放置的左邊或右邊。 (繼承來源 UIElement) |
| KeyTipPlacementMode |
取得或設定值，這個值表示存取密鑰提示相對於 UIElement 界限的位置。 (繼承來源 UIElement) |
| KeyTipTarget |
取得或設定值，這個值表示以訪問鍵提示為目標的專案。 (繼承來源 UIElement) |
| KeyTipVerticalOffset |
取得或設定值，這個值表示索引鍵提示相對於UI元素的上移或下移。 (繼承來源 UIElement) |
| Language |
取得或設定適用於 FrameworkElement的當地語系化/全球化語言資訊，以及套用至物件表示法和 UI 中目前 FrameworkEl ement 的所有子元素。 (繼承來源 FrameworkElement) |
| LeftOfProperty |
識別 RelativePanel.LeftOf XAML 附加屬性。 |
| 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 |
取得或設定框線與其子對象之間的距離。 |
| PaddingProperty |
識別 填補 相依性屬性。 |
| Parent |
取得物件樹狀結構中這個 FrameworkElement 的父物件。 (繼承來源 FrameworkElement) |
| PointerCaptures |
取得所有擷取指標的集合，表示為 指標 值。 (繼承來源 UIElement) |
| Projection |
取得或設定轉譯這個專案時要套用的透視投影（3D 效果）。 (繼承來源 UIElement) |
| ProtectedCursor |
取得或設定指標位於這個專案上方時所顯示的游標。 默認值為 null，表示數據指標沒有變更。 (繼承來源 UIElement) |
| RasterizationScale |
取得值，表示每個檢視圖元的原始（實體）像素數目。 (繼承來源 UIElement) |
| RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用，請參閱。 (繼承來源 UIElement) |
| RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
| RenderTransformOrigin |
取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點，相對於 UIElement界限。 (繼承來源 UIElement) |
| RequestedTheme |
取得或設定 UIElement 及其子元素用於資源判斷的 UI 主題。 您使用 |
| Resources |
取得本機定義的資源字典。 在 XAML 中，您可以透過 XAML 隱含集合語法，將資源專案建立為 |
| RightOfProperty |
識別 RelativePanel.RightOf XAML 附加屬性。 |
| Rotation |
取得或設定順時針旋轉的角度，以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| RotationAxis |
取得或設定要繞著元素旋轉的座標軸。 (繼承來源 UIElement) |
| RotationTransition |
取得或設定 ScalarTransition，以動畫顯示 Rotation 屬性的變更。 (繼承來源 UIElement) |
| Scale |
取得或設定項目的縮放比例。 相對於專案的 CenterPoint 縮放比例。 影響項目的轉譯位置。 (繼承來源 UIElement) |
| ScaleTransition |
取得或設定 Vector3Transition，以動畫顯示 Scale 屬性的變更。 (繼承來源 UIElement) |
| Shadow |
取得或設定 元素所轉換的陰影效果。 (繼承來源 UIElement) |
| Style |
取得或設定在版面配置和轉譯期間套用給這個對象的實例 Style。 (繼承來源 FrameworkElement) |
| TabFocusNavigation |
取得或設定值，這個值會修改Tabbing和 TabIndex 此控件的運作方式。 (繼承來源 UIElement) |
| TabIndex |
取得或設定值，這個值會決定當使用者使用 索引卷標 索引鍵巡覽控件時，專案接收焦點的順序。 (繼承來源 UIElement) |
| Tag |
取得或設定可用來儲存這個物件之自定義資訊的任意物件值。 (繼承來源 FrameworkElement) |
| 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) |
| 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) |
附加屬性
| Above |
取得或設定這個項目位於上方的目標專案。 |
| AlignBottomWith |
取得或設定這個專案的下邊緣對齊的目標專案。 |
| AlignBottomWithPanel |
取得或設定值，這個值表示這個專案的下邊緣是否觸碰面板的下邊緣。 |
| AlignHorizontalCenterWith |
取得或設定這個項目的水準置中對齊的目標專案。 |
| AlignHorizontalCenterWithPanel |
取得或設定值，這個值表示這個專案的水準軸是否觸碰面板的水平軸。 |
| AlignLeftWith |
取得或設定這個專案左邊緣所對齊的目標專案。 |
| AlignLeftWithPanel |
取得或設定值，這個值表示這個專案的左邊緣是否觸碰面板的左邊緣。 |
| AlignRightWith |
取得或設定這個專案右邊緣所對齊的目標專案。 |
| AlignRightWithPanel |
取得或設定值，這個值表示這個專案的右邊緣是否觸碰面板的右邊緣。 |
| AlignTopWith |
取得或設定這個項目上邊緣對齊的目標專案。 |
| AlignTopWithPanel |
取得或設定值，這個值表示這個專案的上邊緣是否觸碰面板的上邊緣。 |
| AlignVerticalCenterWith |
取得或設定這個專案垂直置中對齊的目標專案。 |
| AlignVerticalCenterWithPanel |
取得或設定值，這個值表示這個專案的垂直軸是否觸及面板的水準軸。 |
| Below |
取得或設定這個項目位於下方的目標專案。 |
| LeftOf |
取得或設定這個項目位於 左邊的目標專案。 |
| RightOf |
取得或設定這個項目位於 右邊的目標專案。 |
方法
事件
| 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) |
| GettingFocus |
發生於 UIElement 收到焦點之前。 此事件會以同步方式引發，以確保事件發生反升時不會移動焦點。 (繼承來源 UIElement) |
| GotFocus |
發生於 UIElement 收到焦點時。 這個事件會以異步方式引發，因此焦點可以在升泡完成之前再次移動。 (繼承來源 UIElement) |
| Holding |
發生於未處理的 保留 互動發生在這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| 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) |
| SizeChanged |
發生於 ActualHeight 或 ActualWidth 屬性值變更 FrameworkElement時。 (繼承來源 FrameworkElement) |
| Tapped |
發生於未處理的 Tap 互動發生在這個項目的點擊測試區域時。 (繼承來源 UIElement) |
| Unloaded |
當這個物件不再連接到主要物件樹狀結構時發生。 (繼承來源 FrameworkElement) |