Entry 類別

定義

可以編輯單行文字的控制項。

[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._EntryRenderer))]
public class Entry : Xamarin.Forms.InputView, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.Entry>, Xamarin.Forms.IEntryController, Xamarin.Forms.Internals.IFontElement
type Entry = class
    inherit InputView
    interface IFontElement
    interface IEntryController
    interface IElementConfiguration<Entry>
繼承
屬性
實作

備註

專案是單行文字輸入。 最適合用來收集小型的部分資訊,例如使用者名稱和密碼。

下列範例會建立新的使用者名稱和密碼組專案。

View CreateLoginForm ()
{
  var usernameEntry = new Entry {Placeholder = "Username"};
  var passwordEntry = new Entry {
    Placeholder = "Password",
    IsPassword = true
  };

  return new StackLayout {
    Children = {
      usernameEntry,
      passwordEntry
    }
  };
}

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

建構函式

Entry()

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

欄位

CharacterSpacingProperty
ClearButtonVisibilityProperty
CursorPositionProperty

CursorPosition 屬性的備份存放區。

FontAttributesProperty

FontAttributes 屬性的備份存放區。

FontFamilyProperty

FontFamily 屬性的備份存放區。

FontSizeProperty

FontSize 屬性的備份存放區。

HorizontalTextAlignmentProperty

HorizontalTextAlignment 屬性的備份存放區。

IsPasswordProperty

IsPassword 屬性的備份存放區。

IsTextPredictionEnabledProperty

IsTextPredictionEnabled 屬性的備份存放區。

PlaceholderColorProperty

PlaceholderColor 屬性的備份存放區。

PlaceholderProperty

Placeholder 屬性的備份存放區。

ReturnCommandParameterProperty

ReturnCommandParameter 屬性的備份存放區。

ReturnCommandProperty

ReturnCommand 屬性的備份存放區。

ReturnTypeProperty

ReturnType 屬性的備份存放區。

SelectionLengthProperty

SelectionLength 屬性的備份存放區。

TextColorProperty

TextColor 屬性的備份存放區。

TextProperty

Text 屬性的備份存放區。

VerticalTextAlignmentProperty

屬性

AnchorX

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

(繼承來源 VisualElement)
AnchorY

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

(繼承來源 VisualElement)
AutomationId

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

(繼承來源 Element)
Background (繼承來源 VisualElement)
BackgroundColor

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

(繼承來源 VisualElement)
Batched

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Behaviors

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

(繼承來源 VisualElement)
BindingContext

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

(繼承來源 BindableObject)
Bounds

取得項目的界限。

(繼承來源 VisualElement)
CharacterSpacing

取得或設定值,指出由 Entry 顯示之文字中的字元之間應該有的裝置獨立單位數目。 適用於文字與預留位置。

(繼承來源 InputView)
class (繼承來源 NavigableElement)
ClassId

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

(繼承來源 Element)
ClearButtonVisibility
Clip (繼承來源 VisualElement)
CursorPosition

取得或設定資料指標的位置。

DisableLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Dispatcher (繼承來源 BindableObject)
EffectControlProvider

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Effects

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

(繼承來源 Element)
FlowDirection

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

(繼承來源 VisualElement)
FontAttributes

取得值,指出 Entry 項目文字的字型為粗體、斜體,或兩者皆非。

FontFamily

取得 Entry 項目文字的字型家族。

FontSize

取得 Entry 項目文字的字型大小。

GestureController

取得檢視的軌跡控制器。

(繼承來源 View)
GestureRecognizers

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

(繼承來源 View)
Height

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

(繼承來源 VisualElement)
HeightRequest

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

(繼承來源 VisualElement)
HorizontalOptions

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

(繼承來源 View)
HorizontalTextAlignment

取得或設定水平文字對齊。

Id

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

(繼承來源 Element)
InputTransparent

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

(繼承來源 VisualElement)
IsEnabled

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

(繼承來源 VisualElement)
IsFocused

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

(繼承來源 VisualElement)
IsInNativeLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsNativeStateConsistent

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsPassword

取得或設定值,指出項目是否應該以視覺化方式遮住輸入的文字。

IsPlatformEnabled

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsReadOnly

取得或設定值,指出是否應該防止使用者修改文字。 預設為 false

(繼承來源 InputView)
IsSpellCheckEnabled

取得或設定值,控制是否啟用拼字檢查。

(繼承來源 InputView)
IsTabStop

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

(繼承來源 VisualElement)
IsTextPredictionEnabled

取得或設定值,該值控制文字預測和自動文字更正為開啟還是關閉。

IsVisible

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

(繼承來源 VisualElement)
Keyboard

取得或設定 InputView 的鍵盤。 這是可繫結屬性。

(繼承來源 InputView)
LogicalChildren

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Margin

取得或設定檢視的邊界。

(繼承來源 View)
MaxLength

取得或設定錯誤回應的最大允許長度。

(繼承來源 InputView)
MinimumHeightRequest

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

(繼承來源 VisualElement)
MinimumWidthRequest

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

(繼承來源 VisualElement)
Navigation (繼承來源 NavigableElement)
NavigationProxy (繼承來源 NavigableElement)
Opacity

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

(繼承來源 VisualElement)
Parent

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

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

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

(繼承來源 Element)
Placeholder

當控制項為空白時,取得或設定顯示的文字。

(繼承來源 InputView)
PlaceholderColor

取得或設定預留位置文字的色彩。

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

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Resources

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

(繼承來源 VisualElement)
ReturnCommand

取得或設定當使用者按下返回鍵時要執行的命令。

ReturnCommandParameter

取得或設定 ReturnCommand 的參數。

ReturnType

取得或設定列舉值,該值控制傳回按鈕的外觀。

Rotation

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

(繼承來源 VisualElement)
RotationX

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

(繼承來源 VisualElement)
RotationY

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

(繼承來源 VisualElement)
Scale

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

(繼承來源 VisualElement)
ScaleX

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

(繼承來源 VisualElement)
ScaleY

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

(繼承來源 VisualElement)
SelectionLength

取得選取範圍的長度。

Style (繼承來源 NavigableElement)
StyleClass (繼承來源 NavigableElement)
StyleId

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

(繼承來源 Element)
TabIndex (繼承來源 VisualElement)
Text

取得或設定輸入檢視的文字。 這是可繫結屬性。

(繼承來源 InputView)
TextColor

取得或設定文字色彩。

(繼承來源 InputView)
TextTransform (繼承來源 InputView)
TranslationX

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

(繼承來源 VisualElement)
TranslationY

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

(繼承來源 VisualElement)
Triggers

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

(繼承來源 VisualElement)
VerticalOptions

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

(繼承來源 View)
VerticalTextAlignment
Visual (繼承來源 VisualElement)
Width

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

(繼承來源 VisualElement)
WidthRequest

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

(繼承來源 VisualElement)
X

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

(繼承來源 VisualElement)
Y

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

(繼承來源 VisualElement)

方法

ApplyBindings()

將繫結套用至 BindingContext

(繼承來源 BindableObject)
BatchBegin()

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

(繼承來源 VisualElement)
BatchCommit()

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

(繼承來源 VisualElement)
ChangeVisualState()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
ClearValue(BindableProperty)

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

(繼承來源 BindableObject)
ClearValue(BindablePropertyKey)

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

(繼承來源 BindableObject)
CoerceValue(BindableProperty) (繼承來源 BindableObject)
CoerceValue(BindablePropertyKey) (繼承來源 BindableObject)
Descendants()

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
EffectIsAttached(String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
FindByName(String)

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

(繼承來源 Element)
Focus()

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

(繼承來源 VisualElement)
GetChildElements(Point)

傳回顯示在所指定 point 下的子元素。

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

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

OnBindingContextChanged()

只要 View 的繫結內容變更時就叫用。 覆寫這個方法可以為這個事件加入類別處理。

(繼承來源 View)
OnChildAdded(Element)

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

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

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

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

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

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

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

(繼承來源 VisualElement)
OnParentSet() (繼承來源 NavigableElement)
OnPropertyChanged(String)

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

(繼承來源 Element)
OnPropertyChanging(String)

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

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

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

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

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

(繼承來源 VisualElement)
OnTabIndexPropertyChanged(Int32, Int32) (繼承來源 VisualElement)
OnTabStopPropertyChanged(Boolean, Boolean) (繼承來源 VisualElement)
OnTextChanged(String, String) (繼承來源 InputView)
OnTextTransformChanged(TextTransform, TextTransform) (繼承來源 InputView)
RemoveBinding(BindableProperty)

移除先前設定的繫結。

(繼承來源 BindableObject)
RemoveDynamicResource(BindableProperty)

移除先前設定的動態資源

(繼承來源 Element)
SendCompleted()

供 Xamarin.Forms 平台內部使用。

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() (繼承來源 VisualElement)
TabStopDefaultValueCreator() (繼承來源 VisualElement)
UnapplyBindings()

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

(繼承來源 BindableObject)
Unfocus()

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

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

事件

BatchCommitted

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
BindingContextChanged

每當 BindingContext 屬性變更時引發。

(繼承來源 BindableObject)
ChildAdded

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

(繼承來源 Element)
ChildRemoved

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

(繼承來源 Element)
ChildrenReordered

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

(繼承來源 VisualElement)
Completed

發生於使用者以 Return 鍵完成項目中的文字時。

DescendantAdded

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

(繼承來源 Element)
DescendantRemoved

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

(繼承來源 Element)
FocusChangeRequested

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Focused

在項目取得焦點時發生。

(繼承來源 VisualElement)
MeasureInvalidated

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

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

在屬性變更時引發。

(繼承來源 BindableObject)
PropertyChanging

在屬性即將變更時引發。

(繼承來源 BindableObject)
SizeChanged

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

(繼承來源 VisualElement)
TextChanged

當 Editor 的文字變更時引發的事件。

(繼承來源 InputView)
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)
GetPropertyIfSet<T>(BindableObject, BindableProperty, T)
SetAppThemeColor(BindableObject, BindableProperty, Color, Color)
SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

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

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

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

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)
FindByName<T>(Element, String)

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

FindNextElement(ITabStopElement, Boolean, IDictionary<Int32,List<ITabStopElement>>, Int32)
GetSortedTabIndexesOnParentPage(VisualElement)
GetTabIndexesOnParentPage(ITabStopElement, Int32)
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)
ScaleYTo(VisualElement, Double, UInt32, Easing)
TranslateTo(VisualElement, Double, Double, UInt32, Easing)

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

HasVisualStateGroups(VisualElement)

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

適用於