Label 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
显示文本的 View。
public ref class Label : Microsoft::Maui::Controls::View, Microsoft::Maui::Controls::IDecorableTextElement, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::Label ^>, Microsoft::Maui::Controls::Internals::IFontElement, Microsoft::Maui::Controls::IPaddingElement, Microsoft::Maui::ILabel[Microsoft.Maui.Controls.ContentProperty("Text")]
public class Label : Microsoft.Maui.Controls.View, Microsoft.Maui.Controls.IDecorableTextElement, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.Label>, Microsoft.Maui.Controls.Internals.IFontElement, Microsoft.Maui.Controls.IPaddingElement, Microsoft.Maui.ILabel[<Microsoft.Maui.Controls.ContentProperty("Text")>]
type Label = class
inherit View
interface IFontElement
interface IElementConfiguration<Label>
interface IDecorableTextElement
interface IPaddingElement
interface ILabel
interface IView
interface IElement
interface ITransform
interface IText
interface ITextStyle
interface ITextAlignment
interface IPaddingPublic Class Label
Inherits View
Implements IDecorableTextElement, IElementConfiguration(Of Label), IFontElement, ILabel, IPaddingElement- 继承
- 属性
- 实现
注解
标签用于显示单行文本元素以及多行文本块。
以下示例根据默认 Microsoft.Maui.Controls 解决方案进行了改编，演示了基本用法：
public class App : Application
{
public App ()
{
MainPage = new ContentPage {
Content = new Label {
Text = "Hello, Forms!",
FontSize = Device.GetNamedSize (NamedSize.Large, typeof(Label)),
VerticalOptions = LayoutOptions.CenterAndExpand,
HorizontalOptions = LayoutOptions.CenterAndExpand,
},
};
}
构造函数
| Label() |
初始化 Label 类的新实例。 |
字段
| CharacterSpacingProperty |
的可绑定属性 CharacterSpacing。 |
| ControlsLabelMapper |
已过时.
显示文本的 View。 |
| FontAttributesProperty |
的可绑定属性 FontAttributes。 |
| FontAutoScalingEnabledProperty |
的可绑定属性 FontAutoScalingEnabled。 |
| FontFamilyProperty |
的可绑定属性 FontFamily。 |
| FontSizeProperty |
的可绑定属性 FontSize。 |
| FormattedTextProperty |
的可绑定属性 FormattedText。 |
| HorizontalTextAlignmentProperty |
的可绑定属性 HorizontalTextAlignment。 |
| LineBreakModeProperty |
的可绑定属性 LineBreakMode。 |
| LineHeightProperty |
的可绑定属性 LineHeight。 |
| MaxLinesProperty |
的可绑定属性 MaxLines。 |
| PaddingProperty |
的可绑定属性 Padding。 |
| propertyMapper |
表示视图的内部 PropertyMapper。 (继承自 View) |
| TextColorProperty |
的可绑定属性 TextColor。 |
| TextDecorationsProperty |
的可绑定属性 TextDecorations。 |
| TextProperty |
的可绑定属性 Text。 |
| TextTransformProperty |
的可绑定属性 TextTransform。 |
| TextTypeProperty |
的可绑定属性 TextType。 |
| VerticalTextAlignmentProperty |
的可绑定属性 VerticalTextAlignment。 |
属性
| AnchorX |
获取或设置任何转换操作的中心点的 X 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AnchorY |
获取或设置任何转换操作的中心点的 Y 组件，相对于元素的边界。 这是一种可绑定属性。 (继承自 VisualElement) |
| AutomationId |
获取或设置允许自动化框架查找此元素并与其交互的值。 (继承自 Element) |
| Background |
获取或设置 Brush 将用于填充元素背景的元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| BackgroundColor |
获取或设置 Color 将填充元素的背景。 这是一种可绑定属性。 (继承自 VisualElement) |
| Batched |
获取一个值，该值指示对此元素进行了批处理更改。 (继承自 VisualElement) |
| Behaviors |
获取与此元素关联的对象列表 Behavior 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| BindingContext |
获取或设置一个对象，该对象包含由属于此 BindableObject属性的绑定属性所面向的属性。 这是一种可绑定属性。 (继承自 BindableObject) |
| Bounds |
获取与设备无关的单元中元素的边界。 (继承自 VisualElement) |
| CharacterSpacing |
显示文本的 View。 |
| class |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
| DisableLayout |
获取一个值，该值指示此元素的布局已禁用。 (继承自 VisualElement) |
| Dispatcher |
获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject) |
| EffectControlProvider |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Effects |
获取或设置将在运行时应用于元素的样式和属性。 (继承自 Element) |
| FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
| FontAttributes |
获取一个值，该值指示标签的字体是粗体、斜体还是两者皆否。 |
| FontAutoScalingEnabled |
显示文本的 View。 |
| FontFamily |
获取或设置标签的字体所属的字体系列。 |
| FontSize |
获取标签的字体大小。 |
| FormattedText |
获取或设置 Label 的格式化文本。 这是一种可绑定属性。 |
| Frame |
获取或设置此元素驻留在屏幕上的框架。 (继承自 VisualElement) |
| GestureController |
显示文本的 View。 (继承自 View) |
| GestureRecognizers |
与此视图关联的手势识别器的集合。 (继承自 View) |
| Handler |
获取或设置与此 IViewHandler 元素关联的项。 (继承自 VisualElement) |
| Height |
获取此元素的当前呈现高度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素的所需高度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| HorizontalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| HorizontalTextAlignment |
获取或设置 Text 属性的水平对齐方式。 这是一种可绑定属性。 |
| Id |
获取一个值，该值可用于在应用程序运行过程中唯一标识元素。 (继承自 Element) |
| InputTransparent |
获取或设置一个值，该值指示此元素在用户交互期间是否响应命中测试。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabledCore |
此值表示累积 IsEnabled 值。 重写此属性的所有类型都需要在值更改时调用 RefreshIsEnabledProperty（） 方法。 (继承自 VisualElement) |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsInPlatformLayout |
获取或设置一个值，该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
| IsLoaded |
指示元素是否已连接到主对象树。 (继承自 VisualElement) |
| IsPlatformEnabled |
获取或设置一个值，该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
| IsPlatformStateConsistent |
获取或设置一个值，该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
| IsVisible |
获取或设置一个值，该值确定此元素在屏幕上是否可见，并在布局中占用空间。 这是一种可绑定属性。 (继承自 VisualElement) |
| LineBreakMode |
获取或设置 Label 的 LineBreakMode。 这是一种可绑定属性。 |
| LineHeight |
获取或设置显示文本时要应用于默认行高的乘数。 |
| LogicalChildren |
已过时.
显示文本的 View。 (继承自 Element) |
| Margin |
获取或设置视图的边距。 (继承自 View) |
| MaximumHeightRequest |
获取或设置元素在布局期间请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaximumWidthRequest |
获取或设置元素在布局期间请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaxLines |
获取或设置 Label 中允许的最大行数。 |
| MinimumHeightRequest |
获取或设置元素在布局期间请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置元素在布局期间请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| Navigation |
获取负责处理基于堆栈的导航的对象。 (继承自 NavigableElement) |
| NavigationProxy |
获取转换为 Navigation . NavigationProxy. (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 此值的范围为 0 到 1;超出此范围的值将设置为最接近的有效值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Padding |
显示文本的 View。 |
| Parent |
获取或设置此元素的父 Element 级。 (继承自 Element) |
| RealParent |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| Scale |
获取或设置应用于元素的比例因子。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Shadow |
获取或设置元素强制转换的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
| Style |
获取或设置此元素的唯 Style 一值。 (继承自 NavigableElement) |
| StyleClass |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| Text |
获取或设置 Label 的文本。 这是一种可绑定属性。 |
| TextColor |
获取或设置 Label 的文本的 Color。 这是一种可绑定属性。 |
| TextDecorations |
获取或设置应用于 Text 的 TextDecorations。 |
| TextTransform |
显示文本的 View。 |
| TextType |
确定标签应显示纯文本还是 HTML 文本。 |
| TranslationX |
获取或设置元素的 X 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| TranslationY |
获取或设置元素的 Y 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的对象列表 TriggerBase 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| VerticalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| VerticalTextAlignment |
获取或设置 Text 属性的垂直对齐方式。 这是一种可绑定属性。 |
| Visual |
获取或设置替代 IVisual 元素的视觉外观的实现。 这是一种可绑定属性。 (继承自 VisualElement) |
| Width |
获取此元素的当前宽度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素的所需宽度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| Window |
Window获取与元素关联的项。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| X |
获取此元素的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| ZIndex |
获取或设置布局中元素的前向后 z 索引。 这是一种可绑定属性。 (继承自 VisualElement) |
方法
事件
| BatchCommitted |
通过调用 BatchCommit()提交一批属性更改时发生。 (继承自 VisualElement) |
| BindingContextChanged |
当 BindingContext 属性的值更改时发生。 (继承自 BindableObject) |
| ChildAdded |
每当将子元素添加到元素时引发。 (继承自 Element) |
| ChildRemoved |
每当从元素中删除子元素时引发。 (继承自 Element) |
| ChildrenReordered |
当此元素的子元素的顺序发生更改时发生。 (继承自 VisualElement) |
| DescendantAdded |
每当将子元素添加到元素的子树时引发。 (继承自 Element) |
| DescendantRemoved |
每当从元素子树中删除子元素时引发。 (继承自 Element) |
| FocusChangeRequested |
已过时.
请求焦点更改时发生。 (继承自 VisualElement) |
| Focused |
当此元素处于焦点时发生。 (继承自 VisualElement) |
| HandlerChanged |
每当元素的处理程序发生更改时引发。 (继承自 Element) |
| HandlerChanging |
每当元素的处理程序开始更改时引发。 (继承自 Element) |
| Loaded |
在构造元素并将其添加到平台可视化树时发生。 (继承自 VisualElement) |
| MeasureInvalidated |
当元素的当前度量值失效时发生。 (继承自 VisualElement) |
| ParentChanged |
每当元素的父级发生更改时引发。 (继承自 Element) |
| ParentChanging |
每当元素开始更改时引发。 (继承自 Element) |
| PropertyChanged |
在属性值更改时发生。 (继承自 BindableObject) |
| PropertyChanging |
在属性值更改时发生。 (继承自 BindableObject) |
| SizeChanged |
当元素的大小发生更改时发生。 (继承自 VisualElement) |
| Unfocused |
当此元素未聚焦时发生。 (继承自 VisualElement) |
| Unloaded |
当元素不再连接到平台可视化树时发生。 (继承自 VisualElement) |
