>#Xamarin.Forms Entry 文本框 [TOC] ## Entry简介 tn2>Xamarin.Forms Entry 控件允许对单行文本进行编辑。 本文演示了如何为 Entry 控件创建自定义呈现器，使开发人员能够使用自己特定于平台的自定义呈现替代默认本机呈现。 每个 Xamarin.Forms 控件都有一个附带的呈现器，适用于创建本机控件实例的各个平台。 Xamarin.Forms 应用程序呈现 Entry 控件时，在 iOS 中实例化`EntryRenderer`类，而该操作又会实例化本机`UITextField`控件。 在 Android 平台上，`EntryRenderer` 类实例化 EditText 控件。 在通用 Windows 平台 (UWP) 上，`EntryRenderer` 类实例化 TextBox 控件 下图说明了 Entry 控件和实现它的相应本机控件之间的关系：  ## Entry简单示例 tn2>在Xamarin.Forms项目中创建`Entries.xaml`（Forms ContentPage XAML），编写如下代码： ```xml <?xml version="1.0" encoding="UTF-8" ?> <ContentPage xmlns="http://xamarin.com/schemas/2014/forms" xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml" x:Class="LableApp.Entries"> <ContentPage.Content> <StackLayout> <Entry Text="Tnblog"></Entry> <Entry Text="Tnblog" IsReadOnly="True"></Entry> <Entry Placeholder="Name"></Entry> <Entry Placeholder="Name" PlaceholderColor="Red"></Entry> <Entry Placeholder="Name" MaxLength="15"></Entry> <Entry Placeholder="Password" IsPassword="True"></Entry> <Entry Text="Tnblog" ReturnType="Search"></Entry> <Entry x:Name="txtName"></Entry> <Entry Completed="Entry_Completed"></Entry> <Entry TextChanged="Entry_TextChanged"></Entry> <Label x:Name="lblValue" FontSize="Large" TextColor="Red"></Label> </StackLayout> </ContentPage.Content> </ContentPage> ``` tn2>在后台写入相关事件： ```csharp public partial class Entries : ContentPage { public Entries () { InitializeComponent (); } void Entry_Completed(System.Object sender, System.EventArgs e) { lblValue.Text = ((Entry)sender).Text; } void Entry_TextChanged(System.Object sender, Xamarin.Forms.TextChangedEventArgs e) { lblValue.Text = e.NewTextValue; } } ```   | 常用属性与事件 | 描述 | | ------------ | ------------ | | Text | 获取或设置输入视图的文本。 | | TextColor | 获取或设置文本颜色。 | | Placeholder | 获取或设置在控件为空时显示的文本。 | | PlaceholderColor | 获取或设置占位符文本的颜色。 | | MaxLength | 获取或设置允许的最大输入长度。 | | IsPassword | 获取或设置一个值，该值指示该条目是否应以可视方式遮盖键入的文本。 | | ReturnType | 获取或设置一个枚举值，用于控制返回按钮的外观。 | | Completed | 当用户使用返回键完成条目中的文本时发生。 | | TextChanged | 在编辑器的文本更改时引发的事件。 | | FontSize | 获取 Entry 元素文本的字体大小。 | ## 自定义Entry tn2>通过在每个平台上为 Entry 控件创建自定义呈现器，可以利用呈现过程来实现特定于平台的自定义。 执行此操作的过程如下： 1.创建自定义控件。 2.从 使用自定义控件。 3.在每个平台上为控件创建自定义呈现器。 现在将依次讨论每个项，以在每个平台上实现具有不同背景颜色的 Entry 控件。 >### 创建自定义 Entry 控件 tn2>通过子类化 Entry 控件，可以创建自定义 Entry 控件，如以下示例代码所示： ```csharp public class MyEntry : Entry { } ``` tn2>MyEntry 控件创建在 .NET Standard 库项目中，并且只是 Entry 控件。 将在自定义呈现器中进行控件自定义，因此 MyEntry 控件中无需任何其他实现。 >### 使用自定义控件 tn2>通过在控件元素上声明 MyEntry 自定义控件位置的命名空间并使用命名空间前缀，可以在 .NET Standard 库项目的 XAML 中引用该控件。 下面的代码示例演示 XAML 页可以如何使用 MyEntry 控件： ```csharp <ContentPage xmlns:local="clr-namespace:CustomRenderer;assembly=CustomRenderer"> <local:MyEntry Text="In Shared Code" /> </ContentPage> ``` tn2>local 命名空间前缀可以命名为任何内容。 但是，`clr-namespace` 和 `assembly` 值必须与自定义控件的详细信息相匹配。 声明命名空间后，前缀用于引用自定义控件。 下面的代码示例演示 C# 页可以如何使用 MyEntry 控件： ```csharp public class MainPage : ContentPage { public MainPage () { Content = new StackLayout { Children = { new Label { Text = "Hello, Custom Renderer !", }, new MyEntry { Text = "In Shared Code", } }, VerticalOptions = LayoutOptions.CenterAndExpand, HorizontalOptions = LayoutOptions.CenterAndExpand, }; } } ``` tn2>此代码实例化新的 ContentPage 对象，该对象将在页面上垂直居中以及水平居中显示 Label 和 MyEntry 控件。 现在可以向每个应用程序项目添加自定义呈现器，以便在每个平台上自定义控件外观。 ## 在每个平台上创建自定义呈现器 tn2>EntryRenderer 类公开 OnElementChanged 方法，创建 Xamarin.Forms 控件时调用此方法以呈现对应的本机控件。 此方法采用 ElementChangedEventArgs 参数，其中包含 OldElement 和 NewElement 属性。 这些属性表示 Xamarin.Forms 呈现 Xamarin.Forms 的元素，以及 Xamarin.FormsXamarin.Forms 器附加到的元素。 在示例应用程序中，OldElement 属性将为 null，且 NewElement 属性将包含对 MyEntry 控件的引用。 MyEntryRenderer 类中 OnElementChanged 方法的替代版本可执行本机控件自定义。 可以通过 Control 属性访问平台上使用的对本机控件的类型化引用。 此外，可以通过 Element 属性获取对正在呈现的 Xamarin.Forms 控件的引用，尽管它没有在示例应用程序中使用。 每个自定义呈现器类均用 ExportRenderer 属性修饰，该属性向 Xamarin.Forms 注册呈现器。 该属性采用两个参数：要呈现的 Xamarin.Forms 控件的类型名称和自定义呈现器的类型名称。 属性的 assembly 前缀指示属性适用于整个程序集。 以下各部分讨论每个平台特定的 MyEntryRenderer 自定义呈现器类的实现。 >### 在 iOS 上创建自定义呈现器 tn2>以下代码示例展示了适用于 iOS 平台的自定义呈现器： ```csharp using Xamarin.Forms.Platform.iOS; [assembly: ExportRenderer (typeof(MyEntry), typeof(MyEntryRenderer))] namespace CustomRenderer.iOS { public class MyEntryRenderer : EntryRenderer { protected override void OnElementChanged (ElementChangedEventArgs<Entry> e) { base.OnElementChanged (e); if (Control != null) { // do whatever you want to the UITextField here! Control.BackgroundColor = UIColor.FromRGB (204, 153, 255); Control.BorderStyle = UITextBorderStyle.Line; } } } } ``` tn2>对基类的 `OnElementChanged` 方法的调用实例化 iOS UITextField 控件，并且将对控件的引用分配给呈现器的 Control 属性。 然后，使用 `UIColor.FromRGB` 方法将背景色设置为淡紫色。 >### 在 Android 上创建自定义呈现器 tn2>以下代码示例展示了适用于 Android 平台的自定义呈现器： ```csharp using Xamarin.Forms.Platform.Android; [assembly: ExportRenderer(typeof(MyEntry), typeof(MyEntryRenderer))] namespace CustomRenderer.Android { class MyEntryRenderer : EntryRenderer { public MyEntryRenderer(Context context) : base(context) { } protected override void OnElementChanged(ElementChangedEventArgs<Entry> e) { base.OnElementChanged(e); if (Control != null) { Control.SetBackgroundColor(global::Android.Graphics.Color.LightGreen); } } } } ``` tn2>对基类的 OnElementChanged 方法的调用实例化 Android EditText 控件，并且将对控件的引用分配给呈现器的 Control 属性。 然后，使用 Control.SetBackgroundColor 方法将背景色设置为淡绿色。 >### 在 UWP 上创建自定义呈现器 tn2>以下代码示例展示了适用于 UWP 的自定义呈现器： ```csharp [assembly: ExportRenderer(typeof(MyEntry), typeof(MyEntryRenderer))] namespace CustomRenderer.UWP { public class MyEntryRenderer : EntryRenderer { protected override void OnElementChanged(ElementChangedEventArgs<Entry> e) { base.OnElementChanged(e); if (Control != null) { Control.Background = new SolidColorBrush(Colors.Cyan); } } } } ``` tn2>对基类的 OnElementChanged 方法的调用实例化 TextBox 控件，并且将对控件的引用分配给呈现器的 Control 属性。 然后通过创建 SolidColorBrush 实例将背景色设置为蓝绿色。