Label 類別

定義

可顯示文字的 View

[Xamarin.Forms.ContentProperty("Text")]
[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._LabelRenderer))]
public class Label : Xamarin.Forms.View, Xamarin.Forms.IDecorableTextElement, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.Label>, Xamarin.Forms.Internals.IFontElement
type Label = class
    inherit View
    interface IFontElement
    interface IElementConfiguration<Label>
    interface IDecorableTextElement
繼承
屬性
實作

備註

標籤可用來顯示單行文字元素以及多行文字區塊。

下列範例會根據預設的 Xamarin.Forms 解決方案進行調整,顯示基本用途:

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,
        },
    };
}

FormsGallery 範例可在 [ 範例應用程式 ] 頁面上找到,其具有 LabelDemoPage.cs 檔案。 此檔案包含較長且更完整的範例。

建構函式

Label()

初始化 Label 類別的新執行個體。

欄位

CharacterSpacingProperty

可顯示文字的 View

FontAttributesProperty

FontAttributes 屬性的備份存放區。

FontFamilyProperty

FontFamily 屬性的備份存放區。

FontProperty

Font 可繫結屬性的備份存放區。

FontSizeProperty

FontSize 屬性的備份存放區。

FormattedTextProperty

FormattedText 屬性的備份存放區。

HorizontalTextAlignmentProperty

識別 HorizontalTextAlignment 可繫結屬性

LineBreakModeProperty

LineBreakMode 可繫結屬性的備份存放區。

LineHeightProperty

LineHeight 可繫結屬性的備份存放區。

MaxLinesProperty

MaxLines 提供 BindableProperty 的靜態方法。

PaddingProperty

可顯示文字的 View

TextColorProperty

TextColor 可繫結屬性的備份存放區。

TextDecorationsProperty

提供與 TextDecorations 關聯之 BindableProperty 的靜態方法。

TextProperty

Text 可繫結屬性的備份存放區。

TextTransformProperty

可顯示文字的 View

TextTypeProperty

TextType 可繫結屬性的備份存放區。

VerticalTextAlignmentProperty

識別 VerticalTextAlignment 可繫結屬性。

XAlignProperty
已過時。

XAlign 可繫結屬性的備份存放區。

YAlignProperty
已過時。

YAlign 可繫結屬性的備份存放區。

屬性

AnchorX

取得或設定任何轉換內中心點的 X 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AnchorY

取得或設定任何轉換內中心點的 Y 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AutomationId

取得或設定值,允許自動化架構尋找此項目並與之互動。

(繼承來源 Element)
Background

可顯示文字的 View

(繼承來源 VisualElement)
BackgroundColor

取得或設定將會填滿 VisualElement 背景的色彩。 這是可繫結屬性。

(繼承來源 VisualElement)
Batched

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Behaviors

取得與此元素關聯的行為清單。 這是可繫結屬性。

(繼承來源 VisualElement)
BindingContext

取得或設定物件,這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。

(繼承來源 BindableObject)
Bounds

取得項目的界限。

(繼承來源 VisualElement)
CharacterSpacing

可顯示文字的 View

class

可顯示文字的 View

(繼承來源 NavigableElement)
ClassId

取得或設定值,用來識別語意類似項目的集合。

(繼承來源 Element)
Clip

可顯示文字的 View

(繼承來源 VisualElement)
DisableLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Dispatcher

可顯示文字的 View

(繼承來源 BindableObject)
EffectControlProvider

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Effects

套用至此項目的效果清單。

(繼承來源 Element)
FlowDirection

取得或設定配置流程方向。

(繼承來源 VisualElement)
Font
已過時。

取得或設定 Label 的 Font。 這是可繫結屬性。

FontAttributes

取得值,指出標籤的字型為粗體、斜體,或兩者皆非。

FontFamily

取得或設定標籤所屬字型的字型家族。

FontSize

取得標籤字型的大小。

FormattedText

取得或設定 Label 的格式化文字。 這是可繫結屬性。

GestureController

取得檢視的軌跡控制器。

(繼承來源 View)
GestureRecognizers

與此檢視建立關聯的筆勢辨識器集合。

(繼承來源 View)
Height

取得此項目的目前呈現高度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
HeightRequest

取得或設定此項目所需的高度覆寫項。

(繼承來源 VisualElement)
HorizontalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
HorizontalTextAlignment

取得或設定 Text 屬性的水平對齊。 這是可繫結屬性。

Id

取得值,可用來在應用程式執行期間唯一識別項目。

(繼承來源 Element)
InputTransparent

取得或設定值,這個值指出是否應該在使用者互動週期中包含此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsEnabled

取得或設定值,這個值指出使用者介面中是否已啟用此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsFocused

取得值,這個值指出此項目目前是否為焦點。 這是可繫結屬性。

(繼承來源 VisualElement)
IsInNativeLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsNativeStateConsistent

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsPlatformEnabled

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsTabStop

取得或設定值,這個值表示此元素是否包含於索引標籤巡覽。 這是可繫結屬性。

(繼承來源 VisualElement)
IsVisible

取得或設定值,這個值會決定此項目是否應成為視覺化樹狀結構的一部分。 這是可繫結屬性。

(繼承來源 VisualElement)
LineBreakMode

取得或設定 Label 的 LineBreakMode。 這是可繫結屬性。

LineHeight

取得或設定要在顯示文字時套用至預設行高的乘數。

LogicalChildren

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Margin

取得或設定檢視的邊界。

(繼承來源 View)
MaxLines

取得或設定 Label 中允許的行數上限。

MinimumHeightRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小高度。

(繼承來源 VisualElement)
MinimumWidthRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小寬度。

(繼承來源 VisualElement)
Navigation

可顯示文字的 View

(繼承來源 NavigableElement)
NavigationProxy

可顯示文字的 View

(繼承來源 NavigableElement)
Opacity

取得或設定套用至項目 (呈現時) 的不透明度值。 這是可繫結屬性。

(繼承來源 VisualElement)
Padding

可顯示文字的 View

Parent

取得或設定項目的父項目。

(繼承來源 Element)
ParentView
已過時。

取得即此項目最接近上階的項目,而此項目是 VisualElement

(繼承來源 Element)
Platform
已過時。

可顯示文字的 View

(繼承來源 Element)
RealParent

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Resources

取得或設定本機資源字典。

(繼承來源 VisualElement)
Rotation

取得或設定呈現元素時繞著 Z 軸 (仿射旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationX

取得或設定呈現元素時繞著 X 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationY

取得或設定呈現元素時繞著 Y 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
Scale

取得或設定套用至項目的縮放比例。

(繼承來源 VisualElement)
ScaleX

取得或設定要套用至 X 方向的小數位數值。

(繼承來源 VisualElement)
ScaleY

取得或設定要套用至 Y 方向的小數位數值。

(繼承來源 VisualElement)
Style

可顯示文字的 View

(繼承來源 NavigableElement)
StyleClass

可顯示文字的 View

(繼承來源 NavigableElement)
StyleId

取得或設定使用者定義值來唯一識別項目。

(繼承來源 Element)
TabIndex

可顯示文字的 View

(繼承來源 VisualElement)
Text

取得或設定 Label 的文字。 這是可繫結屬性。

TextColor

取得或設定此 Label 文字的 Color。 這是可繫結屬性。

TextDecorations

取得或設定套用至 TextDecorationsText

TextTransform

可顯示文字的 View

TextType

決定標籤應該顯示純文字或 HTML 文字。

TranslationX

取得或設定項目的 X 轉譯差異。

(繼承來源 VisualElement)
TranslationY

取得或設定項目的 Y 轉譯差異。

(繼承來源 VisualElement)
Triggers

取得與此項目建立關聯的觸發程序清單。 這是可繫結屬性。

(繼承來源 VisualElement)
VerticalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
VerticalTextAlignment

取得或設定 Text 屬性的垂直對齊。 這是可繫結屬性。

Visual

可顯示文字的 View

(繼承來源 VisualElement)
Width

取得此項目的目前呈現寬度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
WidthRequest

取得或設定此項目所需的寬度覆寫項。

(繼承來源 VisualElement)
X

取得此項目的目前 X 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
XAlign
已過時。

取得或設定繫結 Label 內 Text 的水平對齊。

Y

取得此項目的目前 Y 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
YAlign
已過時。

取得或設定繫結 Label 內 Text 的垂直對齊。

方法

ApplyBindings()

將繫結套用至 BindingContext

(繼承來源 BindableObject)
BatchBegin()

表示項目屬性變更批次的開始。

(繼承來源 VisualElement)
BatchCommit()

表示項目命令批次的結束,而且現在應該已認可這些命令。

(繼承來源 VisualElement)
ChangeVisualState()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
ClearValue(BindableProperty)

清除 SetValue 針對 property 所設定的任何值。

(繼承來源 BindableObject)
ClearValue(BindablePropertyKey)

清除 SetValue 針對 propertyKey 所識別屬性設定的任何值。

(繼承來源 BindableObject)
CoerceValue(BindableProperty)

可顯示文字的 View

(繼承來源 BindableObject)
CoerceValue(BindablePropertyKey)

可顯示文字的 View

(繼承來源 BindableObject)
Descendants()

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
EffectIsAttached(String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
FindByName(String)

傳回具有指定名稱的元素。

(繼承來源 Element)
Focus()

嘗試將焦點設定至此項目。

(繼承來源 VisualElement)
GetChildElements(Point)

傳回所指定點下的子元素。

GetSizeRequest(Double, Double)
已過時。

傳回項目的 SizeRequest。 呼叫此方法會開始配置週期的測量傳遞。

(繼承來源 VisualElement)
GetValue(BindableProperty)

傳回 BindableProperty 中包含的值。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
InvalidateMeasure()

用來呼叫而使此 VisualElement 配置失效的方法。 引發 MeasureInvalidated 事件。

(繼承來源 VisualElement)
InvalidateMeasureNonVirtual(InvalidationTrigger)

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsSet(BindableProperty)

如果目標屬性存在且已設定,則傳回 true

(繼承來源 BindableObject)
Layout(Rectangle)

在配置週期期間更新項目的界限。

(繼承來源 VisualElement)
Measure(Double, Double, MeasureFlags)

傳回視覺項目為了在裝置上顯示時所需的最小大小。

(繼承來源 VisualElement)
NativeSizeChanged()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
On<T>()

傳回此 Label 的平台特定執行個體,可在其上呼叫平台特定方法。

OnBindingContextChanged()

繫結內容變更時呼叫的方法。

OnChildAdded(Element)

應用程式開發人員可以覆寫此方法,以便在新增子系時加以回應。

(繼承來源 VisualElement)
OnChildRemoved(Element)
已過時。

應用程式開發人員可以覆寫此方法,以便在移除子系時加以回應。

(繼承來源 VisualElement)
OnChildRemoved(Element, Int32)

可顯示文字的 View

(繼承來源 VisualElement)
OnChildrenReordered()

每當即將發出 ChildrenReordered 事件時叫用。 實作這個方法可為此事件加入類別處理。

(繼承來源 VisualElement)
OnMeasure(Double, Double)

配置度量發生時所呼叫的方法。

(繼承來源 VisualElement)
OnParentSet()

可顯示文字的 View

(繼承來源 NavigableElement)
OnPropertyChanged(String)

繫結屬性變更時呼叫的方法。

(繼承來源 Element)
OnPropertyChanging(String)

從子類別呼叫這個方法,以通知屬性即將發生變更。

(繼承來源 BindableObject)
OnSizeAllocated(Double, Double)

在配置週期期間設定項目的大小時,會呼叫此方法。 在發出 SizeChanged 事件之前會直接呼叫此方法。 實作這個方法可為此事件加入類別處理。

(繼承來源 VisualElement)
OnSizeRequest(Double, Double)
已過時。

這個方法會在配置週期的測量傳遞期間呼叫,以取得項目的所需大小。

(繼承來源 VisualElement)
OnTabIndexPropertyChanged(Int32, Int32)

可顯示文字的 View

(繼承來源 VisualElement)
OnTabStopPropertyChanged(Boolean, Boolean)

可顯示文字的 View

(繼承來源 VisualElement)
RemoveBinding(BindableProperty)

移除先前設定的繫結。

(繼承來源 BindableObject)
RemoveDynamicResource(BindableProperty)

移除先前設定的動態資源

(繼承來源 Element)
SetBinding(BindableProperty, BindingBase)

將繫結指派給屬性。

(繼承來源 BindableObject)
SetDynamicResource(BindableProperty, String)

透過具有所提供索引鍵的 DynamicResource,設定更新此項目的 BindableProperty 屬性。

(繼承來源 Element)
SetValue(BindableProperty, Object)

設定指定之屬性的值。

(繼承來源 BindableObject)
SetValue(BindablePropertyKey, Object)

設定 propertyKey 的值。

(繼承來源 BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
SetValueFromRenderer(BindablePropertyKey, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
SizeAllocated(Double, Double)

在配置週期期間呼叫 SizeAllocated 來表示子樹狀結構配置的開頭。

(繼承來源 VisualElement)
TabIndexDefaultValueCreator()

可顯示文字的 View

(繼承來源 VisualElement)
TabStopDefaultValueCreator()

可顯示文字的 View

(繼承來源 VisualElement)
UnapplyBindings()

取消套用所有先前設定的繫結。

(繼承來源 BindableObject)
Unfocus()

取消將焦點設定至此項目。

(繼承來源 VisualElement)
UpdateFormsText(String, TextTransform)

可顯示文字的 View

事件

BatchCommitted

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
BindingContextChanged

每當 BindingContext 屬性變更時引發。

(繼承來源 BindableObject)
ChildAdded

只要將子項目新增至項目時就發生。

(繼承來源 Element)
ChildRemoved

只要從項目移除子項目時就發生。

(繼承來源 Element)
ChildrenReordered

在 VisualElement 的子系已重新排序時發生。

(繼承來源 VisualElement)
DescendantAdded

只要將子項目新增至項目樹狀子目錄時即發生。

(繼承來源 Element)
DescendantRemoved

只要從項目樹狀子目錄移除子項目時即發生。

(繼承來源 Element)
FocusChangeRequested

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Focused

在項目取得焦點時發生。

(繼承來源 VisualElement)
MeasureInvalidated

視覺項目配置失效時所引發的事件。

(繼承來源 VisualElement)
PlatformSet
已過時。

可顯示文字的 View

(繼承來源 Element)
PropertyChanged

在屬性變更時引發。

(繼承來源 BindableObject)
PropertyChanging

在屬性即將變更時引發。

(繼承來源 BindableObject)
SizeChanged

當這個項目的 Width 或 Height 屬性變更值時發生。

(繼承來源 VisualElement)
Unfocused

在項目失去焦點時發生。

(繼承來源 VisualElement)

明確介面實作

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
IElementController.SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
IFontElement.FontSizeDefaultValueCreator()

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontAttributesChanged(FontAttributes, FontAttributes)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontChanged(Font, Font)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontFamilyChanged(String, String)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontSizeChanged(Double, Double)

供 Xamarin.Forms 平台內部使用。

IGestureController.CompositeGestureRecognizers

供 Xamarin.Forms 平台內部使用。

(繼承來源 View)
INameScope.RegisterName(String, Object)

僅供內部使用。

(繼承來源 Element)
IVisualElementController.EffectiveFlowDirection

取得平台上項目的有效視覺流程方向,並將地區設定和邏輯流程設定納入考量。

(繼承來源 VisualElement)
IVisualElementController.InvalidateMeasure(InvalidationTrigger)

此方法供內部使用。

(繼承來源 VisualElement)

擴充方法

AbortAnimation(IAnimatable, String)

停止動畫。

Animate(IAnimatable, String, Action<Double>, Double, Double, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Action<Double>, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Animation, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate<T>(IAnimatable, String, Func<Double,T>, Action<T>, UInt32, UInt32, Easing, Action<T,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

AnimateKinetic(IAnimatable, String, Func<Double,Double,Boolean>, Double, Double, Action)

設定指定參數並開始動態動畫。

AnimationIsRunning(IAnimatable, String)

傳回布林值,指出由 handle 指定的動畫是否正在執行中。

Batch(IAnimatable)

可顯示文字的 View

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

可顯示文字的 View

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

可顯示文字的 View

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

建立並將繫結套用至屬性。

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
已過時。

從運算式建立及套用繫結。

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)

可顯示文字的 View

FindByName<T>(Element, String)

傳回包含 element 的範圍中具有 name 名稱的 T 類型執行個體。

FindNextElement(ITabStopElement, Boolean, IDictionary<Int32,List<ITabStopElement>>, Int32)

可顯示文字的 View

GetSortedTabIndexesOnParentPage(VisualElement)

可顯示文字的 View

GetTabIndexesOnParentPage(ITabStopElement, Int32)

可顯示文字的 View

FadeTo(VisualElement, Double, UInt32, Easing)

傳回僅根據 opacitylengtheasing 參數描述的內容執行淡化的工作。

LayoutTo(VisualElement, Rectangle, UInt32, Easing)

傳回一個工作,其可將 view 所指定 VisualElement 的邊界,緩移為 bounds 參數所指定的矩形。

RelRotateTo(VisualElement, Double, UInt32, Easing)

view 所指定的 VisualElement,從其目前的旋轉,加以旋轉 drotation

RelScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 從其目前大小縮放至 dscale 的工作。

RotateTo(VisualElement, Double, UInt32, Easing)

傳回執行由 rotationlengtheasing 參數所描述旋轉的工作。

RotateXTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity,耗費時間 length 及使用 easing 扭曲 Y 軸的工作。

RotateYTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity 耗費時間 length 及使用 easing 扭曲 X 軸的工作。

ScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 縮放至絕對縮放比例 scale 的工作。

ScaleXTo(VisualElement, Double, UInt32, Easing)

可顯示文字的 View

ScaleYTo(VisualElement, Double, UInt32, Easing)

可顯示文字的 View

TranslateTo(VisualElement, Double, Double, UInt32, Easing)

將項目 TranslationX 和 TranslationY 屬性,從其目前的值動畫顯示為新值。 這可確保輸入配置在與視覺效果配置相同的位置。

HasVisualStateGroups(VisualElement)

如果 element 具有一或多個與其建立關聯的視覺狀態群組,則傳回 true。 否則傳回 false

適用於