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 : Panel
Public Class RelativePanel
Inherits Panel
<RelativePanel ...>
oneOrMoreUIElements
</RelativePanel>
-or-
<RelativePanel .../>
- 继承
- 属性
示例
提示
有关详细信息、设计指南和代码示例,请参阅 布局面板。
WinUI 3 库 应用包括大多数 WinUI 3 控件、特性和功能的交互式示例。 从 Microsoft Store 获取应用,或在 GitHub上获取源代码。
注解
RelativePanel 是一个布局容器,可用于创建没有明确线性模式的 UI;也就是说,不会从根本上堆叠、包装或表格的布局,其中你自然可以使用 StackPanel 或 网格。
如果 UI 由多个嵌套面板组成,则 RelativePanel 是一个很好的选择。
下面是使用 RelativePanel 进行布局的 UI 示例:
<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>
冲突关系
如果设置多个以元素同一边缘为目标的关系,则可能在布局中存在冲突的关系。 发生这种情况时,关系按以下优先级顺序应用:
- 面板对齐关系(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 并将标识符字段作为依赖属性标识符传递。
Attached 属性 | 描述 |
---|---|
以上 | 获取或设置此元素位于上面的目标元素。
|
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不同。 (继承自 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 |
获取或设置填充面板内容区域的 画笔。 (继承自 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 |
获取或设置 Transition 样式元素的集合,这些元素适用于 Panel 子类的子内容。 (继承自 Panel) |
Clip |
获取或设置用于定义 UIElement内容的轮廓的 RectangleGeometry。 (继承自 UIElement) |
CompositeMode |
获取或设置一个属性,该属性在其父布局和窗口中声明元素的备用组合和混合模式。 这与混合 XAML/Microsoft DirectX UI 中涉及的元素相关。 (继承自 UIElement) |
ContextFlyout |
获取或设置与此元素关联的浮出控件。 (继承自 UIElement) |
CornerRadius |
获取或设置面板边框角的半径。 |
CornerRadiusProperty |
标识 CornerRadius 依赖属性。 |
DataContext |
获取或设置 FrameworkElement的数据上下文。 数据上下文的常见用途是当 |
DesiredSize |
获取此 UIElement 在布局过程的度量传递期间计算的大小。 (继承自 UIElement) |
Dispatcher |
始终在 Windows 应用 SDK 应用中返回 |
DispatcherQueue |
获取与此对象关联的 |
ExitDisplayModeOnAccessKeyInvoked |
获取或设置一个值,该值指定在调用访问密钥时是否消除访问密钥显示。 (继承自 UIElement) |
FlowDirection |
获取或设置文本和其他 UI 元素在控制布局的任何父元素中流动的方向。 此属性可以设置为 |
FocusState |
获取一个值,该值指定此控件是否具有焦点,以及获取焦点的模式。 (继承自 UIElement) |
FocusVisualMargin |
获取或设置 FrameworkElement焦点视觉对象的外部边距。 (继承自 FrameworkElement) |
FocusVisualPrimaryBrush |
获取或设置用于为 FrameworkElement绘制 |
FocusVisualPrimaryThickness |
获取或设置 FrameworkElement的 |
FocusVisualSecondaryBrush |
获取或设置用于为 FrameworkElement绘制 |
FocusVisualSecondaryThickness |
获取或设置 FrameworkElement的 |
Height |
获取或设置 FrameworkElement的建议高度。 (继承自 FrameworkElement) |
HighContrastAdjustment |
获取或设置一个值,该值指示在启用高对比度主题时框架是否自动调整元素的视觉属性。 (继承自 UIElement) |
HorizontalAlignment |
获取或设置在布局父级(如面板或项控件)中组合时应用于 FrameworkElement 的水平对齐特征。 (继承自 FrameworkElement) |
IsAccessKeyScope |
获取或设置一个值,该值指示元素是否定义其自己的访问密钥范围。 (继承自 UIElement) |
IsDoubleTapEnabled |
获取或设置一个值,该值确定 DoubleTapped 事件是否源自该元素。 (继承自 UIElement) |
IsHitTestVisible |
获取或设置此 UIElement 的包含区域是否可以返回命中测试的真实值。 (继承自 UIElement) |
IsHoldingEnabled |
获取或设置一个值,该值确定 保留 事件是否可以源自该元素。 (继承自 UIElement) |
IsItemsHost |
获取一个值,该值指示此 面板 是否是由 ItemsControl生成的 UI 项的容器。 (继承自 Panel) |
IsLoaded |
获取一个值,该值指示是否已将元素添加到元素树中并已准备好进行交互。 (继承自 FrameworkElement) |
IsRightTapEnabled |
获取或设置一个值,该值确定是否 RightTapped 事件源自该元素。 (继承自 UIElement) |
IsTabStop |
获取或设置一个值,该值指示控件是否包含在选项卡导航中。 (继承自 UIElement) |
IsTapEnabled |
获取或设置一个值,该值确定 点击 事件是否源自该元素。 (继承自 UIElement) |
KeyboardAcceleratorPlacementMode |
获取或设置一个值,该值指示控件是否 工具提示 显示其关联的键盘快捷键组合。 (继承自 UIElement) |
KeyboardAcceleratorPlacementTarget |
获取或设置一个值,该值指示显示快捷键组合的控件 工具提示。 (继承自 UIElement) |
KeyboardAccelerators |
获取使用键盘调用操作的键组合的集合。 加速器通常分配给按钮或菜单项。
|
KeyTipHorizontalOffset |
获取或设置一个值,该值指示键提示相对于 UIElement 放置的距离。 (继承自 UIElement) |
KeyTipPlacementMode |
获取或设置一个值,该值指示访问键提示相对于 UIElement 边界的位置。 (继承自 UIElement) |
KeyTipTarget |
获取或设置一个值,该值指示访问键提示所针对的元素。 (继承自 UIElement) |
KeyTipVerticalOffset |
获取或设置一个值,该值指示键提示相对于 UI 元素的向上或向下放置距离。 (继承自 UIElement) |
Language |
获取或设置适用于 FrameworkElement的本地化/全球化语言信息,以及应用于对象表示形式和 UI 中当前 FrameworkElement 的所有子元素。 (继承自 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 |
获取或设置对 Opacity 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
Padding |
获取或设置边框与其子对象之间的距离。 |
PaddingProperty |
标识 填充 依赖属性。 |
Parent |
获取对象树中此 FrameworkElement 的父对象。 (继承自 FrameworkElement) |
PointerCaptures |
获取所有捕获的指针集,这些指针表示为 指针 值。 (继承自 UIElement) |
Projection |
获取或设置呈现此元素时要应用的透视投影(三维效果)。 (继承自 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 |
获取或设置对 Rotation 属性的更改进行动画处理的 ScalarTransition。 (继承自 UIElement) |
Scale |
获取或设置元素的规模。 相对于元素的 CenterPoint 进行缩放。 影响元素的呈现位置。 (继承自 UIElement) |
ScaleTransition |
获取或设置 Vector3Transition,该 Vector3Transition 对 Scale 属性的更改进行动画处理。 (继承自 UIElement) |
Shadow |
获取或设置元素强制转换的阴影效果。 (继承自 UIElement) |
Style |
获取或设置在布局和呈现期间应用于此对象的 Style 实例。 (继承自 FrameworkElement) |
TabFocusNavigation |
获取或设置一个值,该值修改 tabbing 和 TabIndex 对此控件的工作方式。 (继承自 UIElement) |
TabIndex |
获取或设置一个值,该值确定当用户使用 tab 键浏览控件时元素接收焦点的顺序。 (继承自 UIElement) |
Tag |
获取或设置可用于存储有关此对象的自定义信息的任意对象值。 (继承自 FrameworkElement) |
Transform3D |
获取或设置呈现此元素时要应用的三维转换效果。 (继承自 UIElement) |
TransformMatrix |
获取或设置要应用于元素的转换矩阵。 (继承自 UIElement) |
Transitions |
获取或设置应用于 UIElement的 Transition 样式元素的集合。 (继承自 UIElement) |
Translation |
获取或设置元素的 x、y 和 z 呈现位置。 (继承自 UIElement) |
TranslationTransition |
获取或设置 Vector3Transition,该 Vector3Transition 对翻译属性的更改进行动画处理。 (继承自 UIElement) |
Triggers |
获取为 FrameworkElement定义的动画的触发器的集合。 不常使用。 请参阅“备注”。 (继承自 FrameworkElement) |
UseLayoutRounding |
获取或设置一个值,该值确定对象及其视觉子树的呈现是否应使用将呈现与整个像素对齐的舍入行为。 (继承自 UIElement) |
UseSystemFocusVisuals |
获取或设置一个值,该值指示控件是使用由系统绘制的焦点视觉对象还是控件模板中定义的焦点视觉对象。 (继承自 UIElement) |
VerticalAlignment |
获取或设置在父对象(如面板或项控件)中组合时应用于 FrameworkElement 的垂直对齐特征。 (继承自 FrameworkElement) |
Visibility |
获取或设置 UIElement的可见性。 不呈现不可见的 |
Width |
获取或设置 FrameworkElement的宽度。 (继承自 FrameworkElement) |
XamlRoot |
获取或设置正在查看此元素的 |
XYFocusDown |
获取或设置当用户按下游戏控制器方向盘(D 板)时获得焦点的对象。 (继承自 UIElement) |
XYFocusDownNavigationStrategy |
获取或设置一个值,该值指定用于确定向下导航的目标元素的策略。 (继承自 UIElement) |
XYFocusKeyboardNavigation |
获取或设置一个值,该值使用键盘方向箭头启用或禁用导航。 (继承自 UIElement) |
XYFocusLeft |
获取或设置当用户向左按下游戏控制器方向盘(D 板)时获得焦点的对象。 (继承自 UIElement) |
XYFocusLeftNavigationStrategy |
获取或设置一个值,该值指定用于确定左侧导航的目标元素的策略。 (继承自 UIElement) |
XYFocusRight |
获取或设置当用户向右按下游戏控制器方向面板(D 板)时获取焦点的对象。 (继承自 UIElement) |
XYFocusRightNavigationStrategy |
获取或设置一个值,该值指定用于确定右侧导航的目标元素的策略。 (继承自 UIElement) |
XYFocusUp |
获取或设置当用户按下游戏控制器方向面板(D 板)时获得焦点的对象。 (继承自 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 |
当指针设备启动此元素中的 按 操作时发生。 (继承自 UIElement) |
PointerReleased |
在此元素中释放之前启动 按 操作的指针设备时发生。 请注意,新闻 操作的结束不能保证触发 |
PointerWheelChanged |
当指针滚轮的增量值更改时发生。 (继承自 UIElement) |
PreviewKeyDown |
当 UIElement 具有焦点时按下键盘键时发生。 (继承自 UIElement) |
PreviewKeyUp |
当 UIElement 具有焦点时释放键盘键时发生。 (继承自 UIElement) |
ProcessKeyboardAccelerators |
按下 键盘快捷方式(或快捷键) 时发生。 (继承自 UIElement) |
RightTapped |
当指针位于元素上时发生右键输入刺激时发生。 (继承自 UIElement) |
SizeChanged |
当 ActualHeight 或 ActualWidth 属性值更改 FrameworkElement时发生。 (继承自 FrameworkElement) |
Tapped |
在其他未经处理的 点击 交互发生在此元素的命中测试区域时发生。 (继承自 UIElement) |
Unloaded |
当此对象不再连接到主对象树时发生。 (继承自 FrameworkElement) |
适用于
另请参阅
- Panel
- Canvas
- Grid
- StackPanel
- VariableSizedWrapGrid
- 使用 XAML 定义布局
- 快速入门: 添加布局控件
- 对齐、边距和填充
- 控件列表