StackLayout 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在单个垂直或水平行中定位子元素的 Layout<T>。
public class StackLayout : Xamarin.Forms.Layout<Xamarin.Forms.View>, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.StackLayout>type StackLayout = class
inherit Layout<View>
interface IElementConfiguration<StackLayout>- 继承
-
System.ObjectStackLayout
- 实现
注解
由于 StackLayout 布局会覆盖其子元素上的边界，因此应用程序开发人员不应对其设置边界。
以下示例代码（改编自 FormsGallery 示例）演示如何创建一个子级的新 StackLayout 代码，这些子元素探索了以下许多布局行为 StackLayout：
StackLayout stackLayout = new StackLayout
{
Spacing = 0,
VerticalOptions = LayoutOptions.FillAndExpand,
Children =
{
new Label
{
Text = "StackLayout",
HorizontalOptions = LayoutOptions.Start
},
new Label
{
Text = "stacks its children",
HorizontalOptions = LayoutOptions.Center
},
new Label
{
Text = "vertically",
HorizontalOptions = LayoutOptions.End
},
new Label
{
Text = "by default,",
HorizontalOptions = LayoutOptions.Center
},
new Label
{
Text = "but horizontal placement",
HorizontalOptions = LayoutOptions.Start
},
new Label
{
Text = "can be controlled with",
HorizontalOptions = LayoutOptions.Center
},
new Label
{
Text = "the HorizontalOptions property.",
HorizontalOptions = LayoutOptions.End
},
new Label
{
Text = "An Expand option allows one or more children " +
"to occupy the an area within the remaining " +
"space of the StackLayout after it's been sized " +
"to the height of its parent.",
VerticalOptions = LayoutOptions.CenterAndExpand,
HorizontalOptions = LayoutOptions.End
},
new StackLayout
{
Spacing = 0,
Orientation = StackOrientation.Horizontal,
Children =
{
new Label
{
Text = "Stacking",
},
new Label
{
Text = "can also be",
HorizontalOptions = LayoutOptions.CenterAndExpand
},
new Label
{
Text = "horizontal.",
},
}
}
}
};
构造函数
| 名称 | 说明 |
|---|---|
| StackLayout() |
初始化 StackLayout 类的新实例。 |
字段
| 名称 | 说明 |
|---|---|
| OrientationProperty |
标识 Orientation 可绑定属性。 |
| SpacingProperty |
标识间距可绑定属性。 |
属性
| 名称 | 说明 |
|---|---|
| AnchorX |
获取或设置相对于元素边界的任何转换的中心点的 X 组件。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnchorY |
获取或设置相对于元素边界的任何转换的中心点的 Y 分量。 这是一种可绑定属性。 (继承自 VisualElement) |
| AutomationId |
获取或设置允许自动化框架查找此元素并与其交互的值。 (继承自 Element) |
| Background |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 VisualElement) |
| BackgroundColor |
获取或设置将填充 VisualElement 背景的颜色。 这是一种可绑定属性。 (继承自 VisualElement) |
| Batched |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| Behaviors |
获取与此元素关联的行为列表。 这是一种可绑定属性。 (继承自 VisualElement) |
| BindingContext |
获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。 (继承自 BindableObject) |
| Bounds |
获取元素的边界。 (继承自 VisualElement) |
| CascadeInputTransparent |
获取或设置一个值，该值控制子元素在传输时是否继承布局的 |
| Children |
获取布局子元素的 IList<视图> 。 (继承自 Layout<T>) |
| class |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 VisualElement) |
| DisableLayout |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| Dispatcher |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 BindableObject) |
| EffectControlProvider |
供Xamarin内部使用。窗体平台。 (继承自 Element) |
| Effects |
应用于此项的效果的列表。 (继承自 Element) |
| FlowDirection |
获取或设置布局流方向。 (继承自 VisualElement) |
| GestureController |
获取视图的手势控制器。 (继承自 View) |
| GestureRecognizers |
与此视图关联的手势识别器的集合。 (继承自 View) |
| Height |
获取此元素的当前呈现高度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素所需的高度替代。 (继承自 VisualElement) |
| HorizontalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中的布局方式。 这是一种可绑定属性。 (继承自 View) |
| Id |
获取一个值，该值可用于通过应用程序运行唯一标识元素。 (继承自 Element) |
| InputTransparent |
获取或设置一个值，该值指示是否应在用户交互周期中涉及此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsClippedToBounds |
获取或设置一个值，该值确定布局是否应将其子级剪辑到其边界。 (继承自 Layout) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsInNativeLayout |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| IsNativeStateConsistent |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| IsPlatformEnabled |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| IsTabStop |
获取或设置一个值，该值指示此元素是否包含在选项卡导航中。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsVisible |
获取或设置一个值，该值确定此元素是否应是可视化树的一部分。 这是一种可绑定属性。 (继承自 VisualElement) |
| LogicalChildren |
供Xamarin内部使用。窗体平台。 (继承自 Element) |
| Margin |
获取或设置视图的边距。 (继承自 View) |
| MinimumHeightRequest |
获取或设置一个值，该值覆盖元素在布局期间请求的最小高度。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置一个值，该值覆盖元素在布局期间请求的最小宽度。 (继承自 VisualElement) |
| Navigation |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 NavigableElement) |
| NavigationProxy |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Orientation |
获取或设置指示子元素的定位方向的值。 |
| Padding |
获取或设置布局的内部填充。 (继承自 Layout) |
| Parent |
获取或设置元素的父元素。 (继承自 Element) |
| ParentView |
已过时.
获取作为此元素最接近的上级元素的 VisualElement元素。 (继承自 Element) |
| Platform |
已过时.
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 Element) |
| RealParent |
供Xamarin内部使用。窗体平台。 (继承自 Element) |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 (继承自 VisualElement) |
| Scale |
获取或设置应用于元素的比例因子。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 (继承自 VisualElement) |
| Spacing |
获取或设置一个值，该值指示每个子元素之间的空间量。 |
| Style |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 NavigableElement) |
| StyleClass |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| TabIndex |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 VisualElement) |
| TranslationX |
获取或设置元素的 X 转换增量。 (继承自 VisualElement) |
| TranslationY |
获取或设置元素的 Y 转换增量。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的触发器列表。 这是一种可绑定属性。 (继承自 VisualElement) |
| VerticalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中的布局方式。 这是一种可绑定属性。 (继承自 View) |
| Visual |
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 VisualElement) |
| Width |
获取此元素的当前呈现宽度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素的所需宽度重写。 (继承自 VisualElement) |
| X |
获取此元素的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
方法
活动
| 名称 | 说明 |
|---|---|
| BatchCommitted |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| BindingContextChanged |
每当 BindingContext 属性更改时引发。 (继承自 BindableObject) |
| ChildAdded |
每当将子元素添加到元素时发生。 (继承自 Element) |
| ChildRemoved |
每当从元素中删除子元素时发生。 (继承自 Element) |
| ChildrenReordered |
重新排序 VisualElement 的子级时发生。 (继承自 VisualElement) |
| DescendantAdded |
每当将子元素添加到元素子树时发生。 (继承自 Element) |
| DescendantRemoved |
每当从元素子树中删除子元素时发生。 (继承自 Element) |
| FocusChangeRequested |
供Xamarin内部使用。窗体平台。 (继承自 VisualElement) |
| Focused |
当元素接收焦点时发生。 (继承自 VisualElement) |
| LayoutChanged |
如果任何子元素的 Bounds 已更改，则在布局循环结束时发生。 (继承自 Layout) |
| MeasureInvalidated |
当视觉元素的布局失效时引发的事件。 (继承自 VisualElement) |
| PlatformSet |
已过时.
在单个垂直或水平行中定位子元素的 Layout<T>。 (继承自 Element) |
| PropertyChanged |
属性发生更改时引发。 (继承自 BindableObject) |
| PropertyChanging |
当属性即将更改时引发。 (继承自 BindableObject) |
| SizeChanged |
当 Width 或 Height 属性更改此元素上的值时发生。 (继承自 VisualElement) |
| Unfocused |
当元素失去焦点时发生。 (继承自 VisualElement) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IDynamicResourceHandler.SetDynamicResource(BindableProperty, String) |
供Xamarin内部使用。窗体平台。 (继承自 BindableObject) |
| IElementController.SetValueFromRenderer(BindableProperty, Object) |
供Xamarin内部使用。窗体平台。 (继承自 Element) |
| IGestureController.CompositeGestureRecognizers |
供Xamarin内部使用。窗体平台。 (继承自 View) |
| INameScope.RegisterName(String, Object) |
仅供内部使用。 (继承自 Element) |
| IVisualElementController.EffectiveFlowDirection |
获取平台上元素的有效视觉流方向，同时考虑区域设置和逻辑流设置。 (继承自 VisualElement) |
| IVisualElementController.InvalidateMeasure(InvalidationTrigger) |
此方法供内部使用。 (继承自 VisualElement) |