共用方式為


RelativePanel 類別

定義

定義一個區域,您可以在其中放置和對齊彼此或父面板相關的子物件。

/// [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 RelativePanel : Panel
[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 RelativePanel : Panel
Public Class RelativePanel
Inherits Panel
<RelativePanel ...>
  oneOrMoreUIElements
</RelativePanel>
-or-
<RelativePanel .../>
繼承
屬性

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

提示

如需詳細資訊、設計指引和程式碼範例,請參閱版面配置面板。

如果您已安裝 WinUI 2 資源庫 應用程式,請按兩下這裡以 開啟應用程式,並查看 RelativePanel 的運作

備註

RelativePanel 是一種配置容器,可用於建立沒有清楚線性模式的 UI;也就是說,不是基本堆疊、包裝或表格式的配置,您可以在其中自然使用 StackPanelGrid

如果您的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。 如需更多範例,請參閱XAML 回應式技術範例。

預設位置

根據預設,宣告為 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>

衝突關聯性

如果您設定多個以元素相同邊緣為目標的關聯性,則您的版面配置中可能會有衝突的關聯性。 發生這種情況時,會以下列優先順序套用關聯性:

面板中心對齊屬性(AlignVerticalCenterWithAlignHorizontalCenterWithPanel...) 通常獨立於其他條件約束之外使用,而且在沒有衝突時套用。

在評估及套用關聯性屬性之後,會套用 UI 元素上的 HorizontalAlignmentVerticalAlignment 屬性。 如果所需的大小小於可用大小,這些屬性會控制元素在可用大小內的位置。

框線屬性

RelativePanel 定義框線屬性,可讓您在 RelativePanel 周圍繪製框線,而不需使用額外的 Border 元素。 屬性 RelativePanel.BorderBrushRelativePanel.BorderThicknessRelativePanel.CornerRadiusRelativePanel.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 存取子方法。 在程序代碼中取得或設定值的另一種方法是使用相依性屬性系統,呼叫 GetValueSetValue,並將標識符欄位傳遞為相依性屬性標識符。

附加屬性 描述
上述 取得或設定這個項目位於上方的目標專案。
AlignBottomWith 取得或設定這個專案的下邊緣對齊的目標專案。
AlignBottomWithPanel 取得或設定值,這個值表示這個專案的下邊緣是否觸碰面板的下邊緣。
AlignHorizontalCenterWith 取得或設定這個項目的水準置中對齊的目標專案。
AlignHorizontalCenterWithPanel 取得或設定值,這個值表示這個專案的水準軸是否觸碰面板的水平軸。
AlignLeftWith 取得或設定這個專案左邊緣所對齊的目標專案。
AlignLeftWithPanel 取得或設定值,這個值表示這個專案的左邊緣是否觸碰面板的左邊緣。
AlignRightWith 取得或設定這個專案右邊緣所對齊的目標專案。
AlignRightWithPanel 取得或設定值,這個值表示這個專案的右邊緣是否觸碰面板的右邊緣。
AlignTopWith 取得或設定這個項目上邊緣對齊的目標專案。
AlignTopWithPanel 取得或設定值,這個值表示這個專案的上邊緣是否觸碰面板的上邊緣。
AlignVerticalCenterWith 取得或設定這個專案垂直置中對齊的目標專案。
AlignVerticalCenterWithPanel 取得或設定值,這個值表示這個專案的垂直軸是否觸及面板的水準軸。
下方 取得或設定這個項目位於下方的目標專案。
LeftOf 取得或設定這個項目位於 左邊的目標專案。
RightOf 取得或設定這個項目位於 右邊的目標專案。

版本歷程記錄

Windows 版本 SDK 版本 增加值
1809 17763 BackgroundSizing

建構函式

RelativePanel()

初始化 RelativePanel 類別的新實例。

屬性

AboveProperty

識別 RelativePanel.Above XAML 附加屬性。

AccessKey

取得或設定這個項目的訪問鍵(助記鍵)。

(繼承來源 UIElement)
AccessKeyScopeOwner

取得或設定來源專案,提供這個專案的存取鍵範圍,即使它不在來源專案的可視化樹狀結構中也一樣。

(繼承來源 UIElement)
ActualHeight

取得 FrameworkElement的呈現高度。 請參閱。

(繼承來源 FrameworkElement)
ActualOffset

取得這個 UIElement 的位置,相對於其父系,在版面配置程式的排列階段期間計算。

(繼承來源 UIElement)
ActualSize

取得此 UIElement 在版面配置程式的排列階段期間計算的大小。

(繼承來源 UIElement)
ActualTheme

取得專案目前使用的UI主題,該主題可能與 requestedTheme不同。

(繼承來源 FrameworkElement)
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的數據內容。 數據內容的常見用法是當 FrameworkElement 使用 {Binding} 標記延伸並參與數據系結時。

(繼承來源 FrameworkElement)
DesiredSize

取得這個 UIEl ement 在版面配置程式量值階段期間計算的大小。

(繼承來源 UIElement)
Dispatcher

取得與這個對象相關聯的 CoreDispatcherCoreDispatcher 代表可以存取 UI 線程上 DependencyObject 的功能,即使程式代碼是由非 UI 線程起始也一樣。

(繼承來源 DependencyObject)
ExitDisplayModeOnAccessKeyInvoked

取得或設定值,指定叫用存取金鑰時是否關閉存取金鑰顯示。

(繼承來源 UIElement)
FlowDirection

取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 LeftToRightRightToLeft。 在任何元素上將 FlowDirection 設定為 RightToLeft,會將對齊順序設定為從右至左,並將控件的版面配置從右至左流動。

(繼承來源 FrameworkElement)
FocusVisualMargin

取得或設定 FrameworkElement焦點視覺效果的外部邊界。

(繼承來源 FrameworkElement)
FocusVisualPrimaryBrush

取得或設定筆刷,用來繪製 HighVisibilityReveal 焦點視覺效果的 FrameworkElement

(繼承來源 FrameworkElement)
FocusVisualPrimaryThickness

取得或設定 FrameworkElementHighVisibilityReveal 焦點視覺效果的外框線粗細。

(繼承來源 FrameworkElement)
FocusVisualSecondaryBrush

取得或設定筆刷,用來繪製 HighVisibilityReveal 焦點視覺效果的內部框線,FrameworkElement

(繼承來源 FrameworkElement)
FocusVisualSecondaryThickness

取得或設定 FrameworkElementHighVisibilityReveal 焦點視覺效果的內部框線粗細。

(繼承來源 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)
IsTapEnabled

取得或設定值,這個值會決定點選 事件 是否源自該元素。

(繼承來源 UIElement)
KeyboardAcceleratorPlacementMode

取得或設定值,這個值表示控件是否 工具提示 顯示其相關聯鍵盤快捷方式的按鍵組合。

(繼承來源 UIElement)
KeyboardAcceleratorPlacementTarget

取得或設定值,這個值表示顯示快速鍵組合的控件 工具提示

(繼承來源 UIElement)
KeyboardAccelerators

取得使用鍵盤叫用動作的按鍵組合集合。

快捷鍵通常會指派給按鈕或功能表項。

顯示各種功能表項鍵盤快捷鍵的功能表範例
顯示各種功能表項鍵盤快捷鍵的功能表範例

(繼承來源 UIElement)
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)
RenderSize

取得 UIElement的最終轉譯大小。 不建議使用,請參閱。

(繼承來源 UIElement)
RenderTransform

取得或設定會影響 UIElement轉譯位置的轉換資訊。

(繼承來源 UIElement)
RenderTransformOrigin

取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點,相對於 UIElement界限。

(繼承來源 UIElement)
RequestedTheme

取得或設定 UIElement 及其子元素用於資源判斷的 UI 主題。 您使用 RequestedTheme 指定的 UI 主題可以覆寫應用層級 RequestedTheme

(繼承來源 FrameworkElement)
Resources

取得本機定義的資源字典。 在 XAML 中,您可以透過 XAML 隱含集合語法,將資源專案建立為 frameworkElement.Resources 屬性元素的子物件專案。

(繼承來源 FrameworkElement)
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)
Tag

取得或設定可用來儲存這個物件之自定義資訊的任意物件值。

(繼承來源 FrameworkElement)
Transform3D

取得或設定轉譯這個專案時要套用的 3D 轉換效果。

(繼承來源 UIElement)
TransformMatrix

取得或設定要套用至 項目的轉換矩陣。

(繼承來源 UIElement)
Transitions

取得或設定套用至 UIElement之轉換 樣式專案的集合。

(繼承來源 UIElement)
Translation

取得或設定專案的 x、y 和 z 轉譯位置。

(繼承來源 UIElement)
TranslationTransition

取得或設定 Vector3Transition,以動畫顯示 Translation 屬性的變更。

(繼承來源 UIElement)
Triggers

取得為 FrameworkElement定義的動畫觸發程式集合。 不常使用。 請參閱。

(繼承來源 FrameworkElement)
UIContext

取得專案的內容識別碼。

(繼承來源 UIElement)
UseLayoutRounding

取得或設定值,這個值會決定物件及其視覺子樹的轉譯是否應該使用將轉譯對齊整個圖元的四捨五入行為。

(繼承來源 UIElement)
VerticalAlignment

取得或設定在面板或專案控件等父對象中組成時,套用至 FrameworkElement 的垂直對齊特性。

(繼承來源 FrameworkElement)
Visibility

取得或設定 UIElement的可見性。 不會轉譯不可見 UIElement,也不會將其所需的大小傳達給版面配置。

(繼承來源 UIElement)
Width

取得或設定 FrameworkElement的寬度。

(繼承來源 FrameworkElement)
XamlRoot

取得或設定檢視這個專案 XamlRoot

(繼承來源 UIElement)
XYFocusDownNavigationStrategy

取得或設定值,指定用來判斷向下瀏覽之目標元素的策略。

(繼承來源 UIElement)
XYFocusKeyboardNavigation

取得或設定值,這個值會啟用或停用使用鍵盤方向箭號的流覽。

(繼承來源 UIElement)
XYFocusLeftNavigationStrategy

取得或設定值,指定用來判斷左側導覽之目標元素的策略。

(繼承來源 UIElement)
XYFocusRightNavigationStrategy

取得或設定值,指定用來判斷右導覽目標元素的策略。

(繼承來源 UIElement)
XYFocusUpNavigationStrategy

取得或設定值,指定用來判斷向上瀏覽目標元素的策略。

(繼承來源 UIElement)

附加屬性

Above

取得或設定這個項目位於上方的目標專案。

AlignBottomWith

取得或設定這個專案的下邊緣對齊的目標專案。

AlignBottomWithPanel

取得或設定值,這個值表示這個專案的下邊緣是否觸碰面板的下邊緣。

AlignHorizontalCenterWith

取得或設定這個項目的水準置中對齊的目標專案。

AlignHorizontalCenterWithPanel

取得或設定值,這個值表示這個專案的水準軸是否觸碰面板的水平軸。

AlignLeftWith

取得或設定這個專案左邊緣所對齊的目標專案。

AlignLeftWithPanel

取得或設定值,這個值表示這個專案的左邊緣是否觸碰面板的左邊緣。

AlignRightWith

取得或設定這個專案右邊緣所對齊的目標專案。

AlignRightWithPanel

取得或設定值,這個值表示這個專案的右邊緣是否觸碰面板的右邊緣。

AlignTopWith

取得或設定這個項目上邊緣對齊的目標專案。

AlignTopWithPanel

取得或設定值,這個值表示這個專案的上邊緣是否觸碰面板的上邊緣。

AlignVerticalCenterWith

取得或設定這個專案垂直置中對齊的目標專案。

AlignVerticalCenterWithPanel

取得或設定值,這個值表示這個專案的垂直軸是否觸及面板的水準軸。

Below

取得或設定這個項目位於下方的目標專案。

LeftOf

取得或設定這個項目位於 左邊的目標專案。

RightOf

取得或設定這個項目位於 右邊的目標專案。

方法

AddHandler(RoutedEvent, Object, Boolean)

為指定的路由事件新增路由事件處理程式,將處理程式新增至目前元素上的處理程式集合。 指定 handledEventsToo 為 true true 叫用提供的處理程式,即使事件是在其他地方處理也一樣。

(繼承來源 UIElement)
Arrange(Rect)

放置子物件,並決定 UIElement的大小。 為其子元素實作自定義配置的父對象,應該從其版面配置覆寫實作呼叫這個方法,以形成遞歸版面配置更新。

(繼承來源 UIElement)
ArrangeOverride(Size)

提供配置之「排列」階段的行為。 類別可以覆寫此方法,以定義自己的「排列」傳遞行為。

(繼承來源 FrameworkElement)
CancelDirectManipulations()

取消包含目前 UIElement之任何 ScrollViewer 上進行中的直接操作處理(系統定義的移動流覽/縮放)。

(繼承來源 UIElement)
CapturePointer(Pointer)

將指標擷取設定為 UIElement。 擷取之後,只有具有擷取的專案才會引發指標相關事件。

(繼承來源 UIElement)
ClearValue(DependencyProperty)

清除相依性屬性的本機值。

(繼承來源 DependencyObject)
FindName(String)

擷取具有指定標識碼名稱的物件。

(繼承來源 FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

啟用 UIElement 子類別,以公開可協助解析觸控目標的子元素。

(繼承來源 UIElement)
GetAbove(UIElement)

取得目標專案的 RelativePanel.Above XAML 附加屬性的值。

GetAlignBottomWith(UIElement)

取得目標專案的 RelativePanel.AlignBottomWith XAML 附加屬性的值。

GetAlignBottomWithPanel(UIElement)

取得目標元素的 RelativePanel.AlignBottomWithPanel XAML 附加屬性的值。

GetAlignHorizontalCenterWith(UIElement)

取得目標元素 RelativePanel.AlignHorizontalCenterWith XAML 附加屬性的值。

GetAlignHorizontalCenterWithPanel(UIElement)

取得目標元素 RelativePanel.AlignHorizontalCenterWithPanel XAML 附加屬性的值。

GetAlignLeftWith(UIElement)

取得目標專案的 RelativePanel.AlignLeftWith XAML 附加屬性的值。

GetAlignLeftWithPanel(UIElement)

取得目標元素的 RelativePanel.AlignLeftWithPanel XAML 附加屬性的值。

GetAlignRightWith(UIElement)

取得目標專案的 RelativePanel.AlignRightWith XAML 附加屬性的值。

GetAlignRightWithPanel(UIElement)

取得目標專案的 RelativePanel.AlignRightWithPanel XAML 附加屬性的值。

GetAlignTopWith(UIElement)

取得目標元素 RelativePanel.AlignTopWith XAML 附加屬性的值。

GetAlignTopWithPanel(UIElement)

取得目標元素 RelativePanel.AlignTopWithPanel XAML 附加屬性的值。

GetAlignVerticalCenterWith(UIElement)

取得目標元素 RelativePanel.AlignVerticalCenterWith XAML 附加屬性的值。

GetAlignVerticalCenterWithPanel(UIElement)

取得目標元素 RelativePanel.AlignVerticalCenterWithPanel XAML 附加屬性的值。

GetAnimationBaseValue(DependencyProperty)

傳回為相依性屬性建立的任何基底值,這會在動畫未使用的情況下套用。

(繼承來源 DependencyObject)
GetBelow(UIElement)

取得目標專案的 RelativePanel.Below XAML 附加屬性的值。

GetBindingExpression(DependencyProperty)

會傳回代表指定屬性上系結 BindingExpression

(繼承來源 FrameworkElement)
GetChildrenInTabFocusOrder()

啟用 UIElement 子類別,以公開參與 Tab 焦點的子元素。

(繼承來源 UIElement)
GetLeftOf(UIElement)

取得目標專案的 RelativePanel.LeftOf XAML 附加屬性的值。

GetRightOf(UIElement)

取得目標元素 RelativePanel.RightOf XAML 附加屬性的值。

GetValue(DependencyProperty)

DependencyObject 傳回相依性屬性的目前有效值,

(繼承來源 DependencyObject)
GoToElementStateCore(String, Boolean)

在衍生類別中實作時,在程式碼中為控件範本啟用可視化樹狀結構的個別狀態建構,而不是在控件啟動時載入所有狀態的 XAML。

(繼承來源 FrameworkElement)
InvalidateArrange()

使 UIElement的排列狀態(配置)失效。 失效之後,UIElement 將會更新其版面配置,這會以異步方式發生。

(繼承來源 UIElement)
InvalidateMeasure()

使 UIElement的度量狀態 (layout) 失效。

(繼承來源 UIElement)
InvalidateViewport()

使 UIElement 的檢視區狀態失效,此狀態用來計算有效檢視區

(繼承來源 FrameworkElement)
Measure(Size)

更新 UIElementDesiredSize。 一般而言,實作其版面配置子系自定義版面配置的物件會從自己的 MeasureOverride 實作呼叫此方法,以形成遞歸版面配置更新。

(繼承來源 UIElement)
MeasureOverride(Size)

提供配置週期之「量值」階段的行為。 類別可以覆寫這個方法,以定義自己的「量值」傳遞行為。

(繼承來源 FrameworkElement)
OnApplyTemplate()

每當應用程式程式代碼或內部行程(例如重建版面配置階段)呼叫時叫用,ApplyTemplate。 簡單來說,這表示方法只會在應用程式中顯示UI元素之前呼叫。 覆寫此方法以影響類別的預設範本後邏輯。

(繼承來源 FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

在發生 BringIntoViewRequested 事件之前呼叫。

(繼承來源 UIElement)
OnCreateAutomationPeer()

在衍生類別中實作時,會傳回 Microsoft UI 自動化基礎結構的類別特定 AutomationPeer 實作。

(繼承來源 UIElement)
OnDisconnectVisualChildren()

覆寫此方法,以實作當專案從類別特定內容或子屬性中移除專案時,配置和邏輯應該如何運作。

(繼承來源 UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

在應用程式中處理 鍵盤快捷方式(或快捷鍵) 時呼叫。 覆寫此方法,以處理叫用鍵盤快捷鍵時您的應用程式回應方式。

(繼承來源 UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

在應用程式中處理 鍵盤快捷方式(或快捷鍵)之前呼叫。 每當應用程式程式代碼或內部進程呼叫 ProcessKeyboardAccelerators時叫用。 覆寫此方法以影響預設加速器處理。

(繼承來源 UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)

定義可以產生動畫效果的屬性。

(繼承來源 UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

在衍生類別中覆寫時,定義可以產生動畫效果的屬性。

(繼承來源 UIElement)
ReadLocalValue(DependencyProperty)

如果設定本機值,則傳回相依性屬性的本機值。

(繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

註冊通知函式,以接聽此 DependencyObject 實例上特定 DependencyProperty 的變更。

(繼承來源 DependencyObject)
ReleasePointerCapture(Pointer)

釋放指標擷取,以便擷取此 UIElement的特定指標。

(繼承來源 UIElement)
ReleasePointerCaptures()

釋放這個專案保留的所有指標擷取。

(繼承來源 UIElement)
RemoveHandler(RoutedEvent, Object)

從這個 UIElement移除指定的路由事件處理程式。 一般而言,AddHandler新增了有問題的處理程式。

(繼承來源 UIElement)
SetAbove(UIElement, Object)

設定目標元素的 RelativePanel.Above XAML 附加屬性的值。

SetAlignBottomWith(UIElement, Object)

設定目標專案的 RelativePanel.AlignBottomWith XAML 附加屬性的值。

SetAlignBottomWithPanel(UIElement, Boolean)

設定目標專案 RelativePanel.AlignBottomWithPanel XAML 附加屬性的值。

SetAlignHorizontalCenterWith(UIElement, Object)

設定目標元素的 RelativePanel.AlignHorizontalCenterWith XAML 附加屬性的值。

SetAlignHorizontalCenterWithPanel(UIElement, Boolean)

設定 RelativePanel.AlignHorizontalCenterWithPanel 目標元素的 XAML 附加屬性的值。

SetAlignLeftWith(UIElement, Object)

設定目標專案的 RelativePanel.AlignLeftWith XAML 附加屬性的值。

SetAlignLeftWithPanel(UIElement, Boolean)

設定目標專案 RelativePanel.AlignLeftWithPanel XAML 附加屬性的值。

SetAlignRightWith(UIElement, Object)

設定目標專案的 RelativePanel.AlignRightWith XAML 附加屬性的值。

SetAlignRightWithPanel(UIElement, Boolean)

設定目標專案的 RelativePanel.AlignRightWithPanel XAML 附加屬性的值。

SetAlignTopWith(UIElement, Object)

設定目標專案的 RelativePanel.AlignTopWith XAML 附加屬性的值。

SetAlignTopWithPanel(UIElement, Boolean)

設定目標元素的 RelativePanel.AlignTopWithPanel XAML 附加屬性的值。

SetAlignVerticalCenterWith(UIElement, Object)

設定目標元素 RelativePanel.AlignVerticalCenterWith XAML 附加屬性的值。

SetAlignVerticalCenterWithPanel(UIElement, Boolean)

設定目標專案 RelativePanel.AlignVerticalCenterWithPanel XAML 附加屬性的值。

SetBelow(UIElement, Object)

設定目標元素 RelativePanel.Below XAML 附加屬性的值。

SetBinding(DependencyProperty, BindingBase)

使用提供的系結物件,將系結附加至 FrameworkElement

(繼承來源 FrameworkElement)
SetLeftOf(UIElement, Object)

設定目標專案的 RelativePanel.LeftOf XAML 附加屬性的值。

SetRightOf(UIElement, Object)

設定目標元素 RelativePanel.RightOf XAML 附加屬性的值。

SetValue(DependencyProperty, Object)

DependencyObject上設定相依性屬性的本機值。

(繼承來源 DependencyObject)
StartAnimation(ICompositionAnimationBase)

開始元素上的指定動畫。

(繼承來源 UIElement)
StartBringIntoView()

起始 XAML 架構的要求,以將專案納入其內含的任何可捲動區域中檢視。

(繼承來源 UIElement)
StartBringIntoView(BringIntoViewOptions)

起始 XAML 架構的要求,以使用指定的選項將專案帶入檢視。

(繼承來源 UIElement)
StartDragAsync(PointerPoint)

起始拖放作業。

(繼承來源 UIElement)
StopAnimation(ICompositionAnimationBase)

停止元素上的指定動畫。

(繼承來源 UIElement)
TransformToVisual(UIElement)

傳回轉換對象,這個物件可用來將座標從 UIElement 轉換成指定的物件。

(繼承來源 UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

藉由搜尋 UIElement 的整個可視化樹狀結構,嘗試叫用 鍵盤快捷方式(或快捷鍵)

(繼承來源 UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

取消先前透過呼叫 registerPropertyChangedCallback 註冊的變更通知

(繼承來源 DependencyObject)
UpdateLayout()

確保 UIElement 的所有子物件位置都已針對版面配置正確更新。

(繼承來源 UIElement)

事件

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 動作的結尾不保證會引發 PointerReleased 事件;其他事件可能會改為引發。 如需詳細資訊,請參閱。

(繼承來源 UIElement)
PointerWheelChanged

發生於指標滾輪的差異值變更時。

(繼承來源 UIElement)
PreviewKeyDown

發生於按下鍵盤按鍵時,UIElement 有焦點時。

(繼承來源 UIElement)
PreviewKeyUp

UIElement 焦點時放開鍵盤按鍵時發生。

(繼承來源 UIElement)
ProcessKeyboardAccelerators

發生於按下 鍵盤快捷方式(或快捷鍵) 時。

(繼承來源 UIElement)
RightTapped

當指標位於 元素上方時發生右鍵輸入刺激時發生。

(繼承來源 UIElement)
SizeChanged

發生於 ActualHeightActualWidth 屬性值變更 FrameworkElement時。

(繼承來源 FrameworkElement)
Tapped

發生於未處理的 Tap 互動發生在這個項目的點擊測試區域時。

(繼承來源 UIElement)
Unloaded

當這個物件不再連接到主要物件樹狀結構時發生。

(繼承來源 FrameworkElement)

適用於

另請參閱