导出 (0) 打印
全部展开
此文章由人工翻译。 将光标移到文章的句子上,以查看原文。
译文
原文

TextBox 类

表示一个可用于显示单格式、多行文本的控件。

命名空间:  System.Windows.Controls
程序集:  System.Windows(在 System.Windows.dll 中)

[TemplateVisualStateAttribute(Name = "Unfocused", GroupName = "FocusStates")]
[TemplateVisualStateAttribute(Name = "ReadOnly", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "Focused", GroupName = "FocusStates")]
[TemplateVisualStateAttribute(Name = "Disabled", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "MouseOver", GroupName = "CommonStates")]
[TemplateVisualStateAttribute(Name = "Valid", GroupName = "ValidationStates")]
[TemplateVisualStateAttribute(Name = "InvalidUnfocused", GroupName = "ValidationStates")]
[TemplateVisualStateAttribute(Name = "InvalidFocused", GroupName = "ValidationStates")]
[TemplatePartAttribute(Name = "ContentElement", Type = typeof(FrameworkElement))]
[TemplateVisualStateAttribute(Name = "Normal", GroupName = "CommonStates")]
public class TextBox : Control

TextBox 类型公开以下成员。

  名称说明
公共方法受 Silverlight for Windows Phone 支持TextBox初始化 TextBox 类的新实例。
页首

  名称说明
公共属性受 Silverlight for Windows Phone 支持AcceptsReturn获取或设置一个值,该值确定文本框是否允许和显示换行符或回车符。
公共属性受 Silverlight for Windows Phone 支持ActualHeight获取 FrameworkElement 的呈现高度。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持ActualWidth获取 FrameworkElement 的呈现宽度。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持AllowDrop获取或设置一个值,该值确定此 UIElement 是否可用作 Silverlight 拖放操作的放目标。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持Background获取或设置一个用于提供控件背景的画笔。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持BaselineOffset获取表示每个文本行相对于基线的偏移量的值。
公共属性受 Silverlight for Windows Phone 支持BorderBrush获取或设置一个用于描述控件的边框背景的画笔。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持BorderThickness获取或设置控件的边框宽度。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持CacheMode获取或设置一个值,该值指示应在可能时高速缓存已呈现内容。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持CaretBrush获取或设置用于呈现指示插入点的竖线的画笔。
公共属性CharacterSpacing获取或设置以字体大小的千分之一为单位测量的控件中的文本字符之间的距离。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Clip获取或设置用于定义 UIElement 的内容边框的 Geometry (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持Cursor获取或设置鼠标指针悬停在 FrameworkElement 上时所显示的光标图像。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持DataContext获取或设置 FrameworkElement 参与数据绑定时的数据上下文。 (继承自 FrameworkElement。)
受保护的属性受 Silverlight for Windows Phone 支持DefaultStyleKey获取或设置一个键,该键引用控件的默认样式。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持DesiredSize获取此 UIElement 在布局过程的测量处理过程中计算的大小。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持Dispatcher获取与此对象关联的 Dispatcher (继承自 DependencyObject。)
公共属性Effect获取或设置用于呈现此 UIElement 的像素着色器效果。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持FlowDirection获取或设置文本和其他用户界面元素在控制其布局的任何父元素中的流动方向。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持FontFamily获取或设置用于在控件中显示文本的字体。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持FontSize获取或设置此控件中文本的大小。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持FontSource获取或设置应用于 TextBox 以呈现内容的字体源。
公共属性受 Silverlight for Windows Phone 支持FontStretch获取或设置字体在屏幕上的压缩或扩展程度。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持FontStyle获取或设置呈现文本时使用的样式。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持FontWeight获取或设置指定字体的粗细。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Foreground获取或设置一个用于描述前景色的画笔。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Height获取或设置 FrameworkElement 的建议高度。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持HorizontalAlignment获取或设置在布局父级(如面板或项控件)中构成 FrameworkElement 时应用于此元素的水平对齐特征。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持HorizontalContentAlignment获取或设置控件内容的水平对齐方式。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持HorizontalScrollBarVisibility获取或设置水平滚动条的可见性。
公共属性受 Silverlight for Windows Phone 支持InputScope获取或设置此 TextBox 使用的输入的上下文。
公共属性受 Silverlight for Windows Phone 支持IsEnabled获取或设置一个值,该值指示用户是否可以与控件交互。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持IsHitTestVisible获取或设置此 UIElement 的包含区域是否可为命中测试返回 true 值。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持IsReadOnly获取或设置一个值,该值确定用户是否能够在文本框中更改文本。
公共属性受 Silverlight for Windows Phone 支持IsTabStop获取或设置一个值,该值指示是否将某个控件包含在 Tab 导航中。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Language获取或设置应用于 FrameworkElement 的本地化/全球化语言信息。 (继承自 FrameworkElement。)
公共属性LineHeight获取或设置各行内容的高度。
公共属性LineStackingStrategy获取或设置一个值,该值指示如何为 TextBox 中的每行文本确定一个行框。
公共属性受 Silverlight for Windows Phone 支持Margin获取或设置 FrameworkElement 的外边距。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持MaxHeight获取或设置 FrameworkElement 的最大高度约束。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持MaxLength获取或设置一个值,该值确定用户输入所允许的最大字符数。
公共属性受 Silverlight for Windows Phone 支持MaxWidth获取或设置 FrameworkElement 的最大宽度约束。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持MinHeight获取或设置 FrameworkElement 的最小高度约束。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持MinWidth获取或设置 FrameworkElement 的最小宽度约束。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持Name获取或设置对象的标识名称。 在 XAML 处理器从 XAML 标记创建对象树后,运行时代码可以使用此名称引用 XAML 声明的对象。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持Opacity获取或设置对象的不透明度。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持OpacityMask获取或设置用于改变此对象区域的不透明度的画笔。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持Padding获取或设置控件内的边距。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Parent获取对象树中此 FrameworkElement 的父对象。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持Projection获取或设置在呈现此 UIElement 时要应用的透视投影(三维效果)。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持RenderSize获取 UIElement 的最终呈现大小。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持RenderTransform获取或设置影响 UIElement 的呈现位置的变换信息。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持RenderTransformOrigin获取或设置由 RenderTransform 声明的任何可能呈现变换的原点,相对于 UIElement 的边界。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持Resources获取本地定义的资源字典。 在 XAML 中,可以通过 XAML 隐式集合语法,将资源项建立为 frameworkElement.Resources 属性元素的子对象元素。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持SelectedText获取或设置文本框中当前选择的内容。
公共属性受 Silverlight for Windows Phone 支持SelectionBackground获取或设置填充选定文本的背景的画笔。
公共属性受 Silverlight for Windows Phone 支持SelectionForeground获取或设置用于文本框中选定文本的画笔。
公共属性受 Silverlight for Windows Phone 支持SelectionLength获取或设置文本框中当前选定内容的字符数。
公共属性受 Silverlight for Windows Phone 支持SelectionStart获取或设置文本框中选定文本的起始位置。
公共属性受 Silverlight for Windows Phone 支持Style获取或设置呈现过程中应用于此对象的实例 Style (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持TabIndex获取或设置一个值,该值决定在用户使用 Tab 键在控件中导航时元素接收焦点的顺序。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持TabNavigation获取或设置一个值,该值修改 Tab 键和 TabIndex 针对此控件的工作方式。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Tag获取或设置一个可用于存储有关此对象的自定义信息的任意对象值。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持Template获取或设置控件模板。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持Text获取或设置文本框的文本内容。
公共属性受 Silverlight for Windows Phone 支持TextAlignment获取或设置文本应在文本框中进行对齐的方式。
公共属性受 Silverlight for Windows Phone 支持TextWrapping获取或设置当一行文本超过文本框的可用宽度后如何进行换行。
公共属性受 Silverlight for Windows Phone 支持Triggers获取为 FrameworkElement 定义的动画的触发器的集合。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持UseLayoutRounding获取或设置一个值,该值确定对象及其可视化子树的呈现是否应使用将呈现与整像素对齐的舍入行为。 (继承自 UIElement。)
公共属性受 Silverlight for Windows Phone 支持VerticalAlignment获取或设置在父对象(如面板或项控件)中构成 FrameworkElement 时应用于此元素的垂直对齐特征。 (继承自 FrameworkElement。)
公共属性受 Silverlight for Windows Phone 支持VerticalContentAlignment获取或设置控件内容的垂直对齐方式。 (继承自 Control。)
公共属性受 Silverlight for Windows Phone 支持VerticalScrollBarVisibility获取或设置垂直滚动条的可见性。
公共属性受 Silverlight for Windows Phone 支持Visibility获取或设置 UIElement 的可见性。 不可见的 UIElement 不呈现,也不将其所需大小告知布局。 (继承自 UIElement。)
公共属性Watermark不实现此属性。
公共属性受 Silverlight for Windows Phone 支持Width获取或设置 FrameworkElement 的宽度。 (继承自 FrameworkElement。)
页首

  名称说明
公共方法受 Silverlight for Windows Phone 支持AddHandler为指定的路由事件添加路由事件处理程序,并将该处理程序添加到当前元素的处理程序集合中。 handledEventsToo 指定为 true 时,可为已标记为由其他元素在事件路由过程中处理的路由事件调用所提供的处理程序。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持ApplyTemplate加载相关的控件模板,以便可以引用其部件。 (继承自 Control。)
公共方法受 Silverlight for Windows Phone 支持Arrange定位子对象并确定 UIElement 的大小。 为其子元素实现自定义布局的父对象应从其布局重写实现调用此方法以形成递归布局更新。 (继承自 UIElement。)
受保护的方法受 Silverlight for Windows Phone 支持ArrangeOverride提供 Silverlight 布局的排列处理过程的行为。 类可以重写该方法来定义其自己的排列处理过程行为。 (继承自 FrameworkElement。)
公共方法受 Silverlight for Windows Phone 支持CaptureMouse将鼠标捕获设置为 UIElement (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持CheckAccess确定调用线程是否可以访问此对象。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持ClearValue清除依赖项属性的本地值。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持Equals(Object)确定指定的 Object 是否等于当前的 Object (继承自 Object。)
受保护的方法受 Silverlight for Windows Phone 支持Finalize允许对象在垃圾回收对 Object 进行回收之前尝试释放资源并执行其他清理操作。 (继承自 Object。)
公共方法受 Silverlight for Windows Phone 支持FindName检索具有指定标识符名称的对象。 (继承自 FrameworkElement。)
公共方法受 Silverlight for Windows Phone 支持Focus尝试设置控件的焦点。 (继承自 Control。)
公共方法受 Silverlight for Windows Phone 支持GetAnimationBaseValue返回为 Silverlight 依赖项属性设置的任意基值,在动画不活动时将应用它们。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持GetBindingExpression检索 BindingExpression 中已建立绑定的依赖项属性。 (继承自 FrameworkElement。)
公共方法受 Silverlight for Windows Phone 支持GetHashCode用作特定类型的哈希函数。 (继承自 Object。)
公共方法受 Silverlight for Windows Phone 支持GetRectFromCharacterIndex(Int32)返回指定索引处字符的前边缘的边框。
公共方法受 Silverlight for Windows Phone 支持GetRectFromCharacterIndex(Int32, Boolean)返回指定索引处字符的前边缘或后边缘的边框。
受保护的方法受 Silverlight for Windows Phone 支持GetTemplateChild在实例化的 ControlTemplate 可视化树中检索已命名的元素。 (继承自 Control。)
公共方法受 Silverlight for Windows Phone 支持GetType获取当前实例的 Type (继承自 Object。)
公共方法受 Silverlight for Windows Phone 支持GetValueDependencyObject 返回依赖项属性的当前有效值。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持InvalidateArrange使 UIElement 的排列状态(布局)无效。 使其无效后,将会更新 UIElement 的布局(以异步方式进行)。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持InvalidateMeasure使 UIElement 的测量状态(布局)无效。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持Measure更新 UIElementDesiredSize 一般地,实现其布局子级的自定义布局的对象从自己的 MeasureOverride 实现调用此方法以形成递归布局更新。 (继承自 UIElement。)
受保护的方法受 Silverlight for Windows Phone 支持MeasureOverride提供 Silverlight 布局的度量处理过程的行为。 类可以重写该方法来定义其自己的度量处理过程行为。 (继承自 FrameworkElement。)
受保护的方法受 Silverlight for Windows Phone 支持MemberwiseClone创建当前 Object 的浅表副本。 (继承自 Object。)
公共方法受 Silverlight for Windows Phone 支持OnApplyTemplate在派生类中重写后,每当应用程序代码或内部进程(如重新生成布局处理过程)调用 ApplyTemplate,都将调用此方法。 简而言之,这意味着就在 UI 元素在应用程序中显示前调用该方法。 有关更多信息,请参见“备注”。 (继承自 FrameworkElement。)
受保护的方法受 Silverlight for Windows Phone 支持OnCreateAutomationPeer返回一个 TextBoxAutomationPeer,供 Silverlight 自动化基础结构使用。 (重写 UIElement.OnCreateAutomationPeer()。)
受保护的方法受 Silverlight for Windows Phone 支持OnDoubleTapDoubleTap 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnDragEnterDragEnter 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnDragLeaveDragLeave 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnDragOverDragOver 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnDropDrop 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnGotFocusGotFocus 事件发生之前调用。 (重写 Control.OnGotFocus(RoutedEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnHoldHold 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnKeyDownKeyDown 事件发生时调用。 (重写 Control.OnKeyDown(KeyEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnKeyUpKeyUp 事件发生之前调用。 (重写 Control.OnKeyUp(KeyEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnLostFocusLostFocus 事件发生之前调用。 (重写 Control.OnLostFocus(RoutedEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnLostMouseCaptureLostMouseCapture 事件提供处理。 (重写 Control.OnLostMouseCapture(MouseEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnManipulationCompletedManipulationCompleted 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnManipulationDeltaManipulationDelta 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnManipulationStartedManipulationStarted 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseEnterMouseEnter 事件发生之前调用。 (重写 Control.OnMouseEnter(MouseEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseLeaveMouseLeave 事件发生之前调用。 (重写 Control.OnMouseLeave(MouseEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseLeftButtonDownMouseLeftButtonDown 事件发生之前调用。 (重写 Control.OnMouseLeftButtonDown(MouseButtonEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseLeftButtonUpMouseLeftButtonUp 事件发生之前调用。 (重写 Control.OnMouseLeftButtonUp(MouseButtonEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseMoveMouseMove 事件发生之前调用。 (重写 Control.OnMouseMove(MouseEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseRightButtonDownMouseRightButtonDown 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseRightButtonUpMouseRightButtonUp 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnMouseWheelMouseWheel 事件发生之前调用,用于在不附加委托的情况下为派生类中的事件提供处理。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnTapTap 事件发生之前调用。 (继承自 Control。)
受保护的方法受 Silverlight for Windows Phone 支持OnTextInputTextInput 事件发生之前调用。 (重写 Control.OnTextInput(TextCompositionEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnTextInputStartTextInputStart 事件发生之前调用。 (重写 Control.OnTextInputStart(TextCompositionEventArgs)。)
受保护的方法受 Silverlight for Windows Phone 支持OnTextInputUpdateTextInputUpdate 事件发生之前调用。 (重写 Control.OnTextInputUpdate(TextCompositionEventArgs)。)
公共方法受 Silverlight for Windows Phone 支持ReadLocalValue返回依赖项属性的本地值(如果设置了本地值)。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持ReleaseMouseCaptureUIElement 中移除鼠标捕获。 在此调用后,一般没有对象具有鼠标捕获。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持RemoveHandler从此 UIElement 中移除指定的路由事件处理程序。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持Select选择文本框中的文本范围。
公共方法受 Silverlight for Windows Phone 支持SelectAll选择文本框的全部内容。
公共方法受 Silverlight for Windows Phone 支持SetBinding使用提供的绑定对象,将绑定附加到 FrameworkElement 上,并返回 BindingExpressionBase 以供以后使用。 (继承自 FrameworkElement。)
公共方法受 Silverlight for Windows Phone 支持SetValueDependencyObject 设置依赖项属性的本地值。 (继承自 DependencyObject。)
公共方法受 Silverlight for Windows Phone 支持ToString返回表示当前对象的字符串。 (继承自 Object。)
公共方法受 Silverlight for Windows Phone 支持TransformToVisual返回一个变换对象,该变换对象可用于将 UIElement 中的坐标变换为指定的对象。 (继承自 UIElement。)
公共方法受 Silverlight for Windows Phone 支持UpdateLayout请确保 UIElement 的所有子对象位置都正确地进行了布局更新。 (继承自 UIElement。)
页首

  名称说明
公共事件受 Silverlight for Windows Phone 支持BindingValidationError在绑定源报告数据验证错误时发生。 (继承自 FrameworkElement。)
公共事件DataContextChanged当此元素的数据上下文更改时发生。 (继承自 FrameworkElement。)
公共事件受 Silverlight for Windows Phone 支持DoubleTap在此 UIElement 上方提交 DoubleTap 手势时发生。 (继承自 UIElement。)
公共事件DragEnter在输入系统报告将此元素作为目标的基础拖动事件时发生。 (继承自 UIElement。)
公共事件DragLeave在输入系统报告将此元素作为来源的基础拖动事件时发生。 (继承自 UIElement。)
公共事件DragOver在输入系统报告将此元素作为潜在放置目标的基础拖动事件时发生。 (继承自 UIElement。)
公共事件Drop在输入系统报告将此元素作为放置目标的基础放置事件时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持GotFocusUIElement 收到焦点时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持Hold在此 UIElement 上方提交 Hold 手势时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持IsEnabledChangedIsEnabled 属性更改时发生。 (继承自 Control。)
公共事件受 Silverlight for Windows Phone 支持KeyDownUIElement 具有焦点的情况下按下键盘上的某个键时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持KeyUpUIElement 具有焦点的情况下释放键盘上的某个键时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持LayoutUpdated当 Silverlight 可视化树的布局更改时发生。 (继承自 FrameworkElement。)
公共事件受 Silverlight for Windows Phone 支持Loaded当已构造 FrameworkElement 并将其添加到对象树中时发生。 (继承自 FrameworkElement。)
公共事件受 Silverlight for Windows Phone 支持LostFocusUIElement 失去焦点时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持LostMouseCaptureUIElement 失去鼠标捕获时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持ManipulationCompleted对于 UIElement 的操作和延时完毕时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持ManipulationDelta当输入设备在操作期间更改位置时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持ManipulationStarted当输入设备对 UIElement 开始操作时发生。 (继承自 UIElement。)
公共事件MediaCommand在按下遥控器上的某个按钮时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseEnter当鼠标(或触笔)进入 UIElement 的边界区域时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseLeave当鼠标(或触笔)离开 UIElement 的边界区域时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseLeftButtonDown当按下鼠标左键(或触笔的笔尖接触 Tablet)并且鼠标指针悬停在 UIElement 上时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseLeftButtonUp当鼠标(或触笔)悬停在 UIElement 上(或 UIElement 具有鼠标捕获)并且用户松开鼠标左键(或从 Tablet 上移开触笔的笔尖)时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseMove当鼠标(或触笔)的坐标位置更改并且悬停在 UIElement 上(或 UIElement 具有鼠标捕获)时发生。 (继承自 UIElement。)
公共事件MouseRightButtonDown当鼠标指针位于 UIElement 上并按下鼠标右键时发生。 (继承自 UIElement。)
公共事件MouseRightButtonUp当鼠标指针位于 UIElement 上并释放鼠标右键时发生。 但是,只有在调用方将前面的 MouseRightButtonDown 事件标记为“已处理”时才引发此事件;请参见“备注”。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持MouseWheel在以下情况下发生:当鼠标指针悬停在 UIElement 上时或 UIElement 具有焦点时,用户滚动鼠标滚轮。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持SelectionChanged在文本选定内容更改后发生。
公共事件受 Silverlight for Windows Phone 支持SizeChangedFrameworkElement 上的 ActualHeightActualWidth 属性的值发生更改时发生。 (继承自 FrameworkElement。)
公共事件受 Silverlight for Windows Phone 支持Tap在此 UIElement 上方提交 Tap 手势时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持TextChanged在文本框中的内容更改时发生。
公共事件受 Silverlight for Windows Phone 支持TextInput在 UI 元素以与设备无关的方式获取文本时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持TextInputStart在 UI 元素以与设备无关的方式最初获取文本时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持TextInputUpdate当通过输入方法编辑器 (IME) 继续编写文本时发生。 (继承自 UIElement。)
公共事件受 Silverlight for Windows Phone 支持Unloaded当此对象不再与主对象树连接时发生。 (继承自 FrameworkElement。)
页首

  名称说明
公共字段静态成员受 Silverlight for Windows Phone 支持AcceptsReturnProperty标识 AcceptsReturn 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持CaretBrushProperty标识 CaretBrush 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持InputScopeProperty标识 InputScope 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持IsReadOnlyProperty标识 IsReadOnly 依赖项属性。
公共字段静态成员LineHeightProperty标识 LineHeight 依赖项属性。
公共字段静态成员LineStackingStrategyProperty标识 LineStackingStrategy 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持MaxLengthProperty标识 MaxLength 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持SelectionBackgroundProperty标识 SelectionBackground 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持SelectionForegroundProperty标识 SelectionForeground 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持TextAlignmentProperty标识 TextAlignment 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持TextProperty标识 Text 依赖项属性。
公共字段静态成员受 Silverlight for Windows Phone 支持TextWrappingProperty标识 TextWrapping 依赖项属性。
公共字段静态成员WatermarkProperty标识 Watermark 依赖项属性。
页首

可以通过使用 AcceptsReturn 属性在 TextBox 控件中启用多行文本。 使用 HorizontalScrollBarVisibilityVerticalScrollBarVisibility 属性以启用水平滚动条或垂直滚动条。 有关演示带有滚动条的多行文本框控件的示例,请参见 AcceptsReturn 属性。

您可能希望使用文本框来显示文本,但您可能不希望用户能够编辑文本。 可以使用 IsReadOnly 属性实现此目的。 如果您将文本框的 IsReadOnly 属性设置为 true,则不支持编辑命令,并且将 KeyUpKeyDown 事件标记为 handled 如果您需要用户无法编辑的格式化文本,则使用 TextBlock 控件。 如果您需要接受密码或其他敏感输入的可编辑文本框,请参见 PasswordBox

可以使用 BorderThicknessBorderBrush 属性修改 TextBox 的边框。 隐藏 TextBox 周围的边框的最好方法是将 TextBoxBorderThickness 属性设置为 0。

重写 ArrangeOverride 方法时,您必须排列可见子级。 否则,排列行为可能未定义。

内容模型: TextBox 的内容属性是 Text 有关文本框的内容模型的更多信息,请参见控件内容模型

自定义 TextBox 控件

若要对多个 TextBox 控件应用相同的属性设置,请使用 Style 属性。 若要更改 TextBox 的可视结构和可视行为,请复制并修改它的默认样式和模板。 有关更多信息,请参见 控件自定义

可通过控件的默认样式设置此控件的依赖项属性。 如果 TextBox 的依赖项属性由它的默认样式设置,则当 TextBox 显示在应用程序中时,该属性的值可能会由默认值更改为其他值。 有关更多信息,请参见 依赖项属性值优先级 您可以从 TextBox 样式和模板获取 TextBox 的默认样式和模板。

注意说明:

仅当可视属性显示在 TextBox 控件的默认模板中,并且是使用 TemplateBinding 设置的时,设置该可视属性才有效。 通过使用 ControlTemplate 自定义现有控件的外观的"更改控件的可视结构"部分中,可以找到可视属性的列表。

版本说明

Silverlight for Windows Phone Silverlight for Windows Phone

在 Windows Phone OS 7.1 中设置 FontFamily 属性为下载的或包含在文件中的字体时,TextBox 在位置 (0,0) 呈现。 字体完成下载后,应用程序再次呈现,TextBox 在正确位置。

下面的代码示例演示的文本框控件用于说明 TextBox 对象的不同属性和事件。

运行此示例


<StackPanel x:Name="LayoutRoot" Background="White">

    <TextBlock Margin="20,20,0,0" Text="Type Text Here"/>

    <TextBox x:Name="ReadWriteTB" TextChanged="ReadWriteTB_TextChanged"  IsReadOnly="False" HorizontalAlignment="Left" Margin="20,5,0,0" Height="35" Width="200" />

    <TextBlock Margin="20,20,0,0" Text="Read Only TextBox"/>

    <TextBox x:Name="ReadOnlyTB"  IsReadOnly="True" HorizontalAlignment="Left" Margin="20,5,0,0" Height="35" Width="200" />

    <TextBlock Margin="20,30,0,0" Text="Search Type TextBox" />

    <TextBlock Margin="20,0,0,0" FontSize="11">
        The following text box has a watermark text (Search). The text is gray until you click inside the text box. 
        <LineBreak />
        When you click inside the text box the watermark text is removed and the cursor appears ready for input.
    </TextBlock>

    <TextBox x:Name="SearchTB" Margin="20,5,0,0" Text="Search" HorizontalAlignment="Left" Height="35" Width="200" Foreground="Gray" GotFocus="SearchTB_GotFocus" LostFocus="SearchTB_LostFocus" />

    <TextBlock Margin="20,40,0,0" Text="Demonstrating styles for TextBox" />

    <TextBlock Margin="20,0,0,0" FontSize="11">
        Select the following text to view the results of SelectionForeground and SelectionBackground properties.
    </TextBlock>

    <TextBox Text="Styles" Margin="20,5,0,0" HorizontalAlignment="Left" Width="200" Height="35" FontFamily="Arial" FontSize="15" Foreground="White" Background="Black" BorderBrush="White" SelectionForeground="Black">
        <TextBox.SelectionBackground>
            <LinearGradientBrush StartPoint="0,0" EndPoint="0,1">
                <GradientStop Color="Gray" Offset="0.0" />
                <GradientStop Color="White" Offset="1.0" />
            </LinearGradientBrush>
        </TextBox.SelectionBackground>
    </TextBox>
</StackPanel>



Public Class Page
    Inherits UserControl

    Public Sub New()
        MyBase.New()
        InitializeComponent()
    End Sub

    'The following method displays the text entered in ReadWriteTB in ReadOnlyTB.
    Private Sub ReadWriteTB_TextChanged(ByVal sender As Object, ByVal e As RoutedEventArgs)
        ReadOnlyTB.Text = ReadWriteTB.Text
    End Sub

    'The foreground color of the text in SearchTB is set to Magenta when SearchTB
    'gets focus.
    Private Sub SearchTB_GotFocus(ByVal sender As Object, ByVal e As RoutedEventArgs)
        SearchTB.Text = ""
        Dim Brush1 As SolidColorBrush = New SolidColorBrush
        Brush1.Color = Colors.Magenta
        SearchTB.Foreground = Brush1
    End Sub

    'The foreground color of the text in SearchTB is set to Blue when SearchTB
    'loses focus. Also, if SearchTB loses focus and no text is entered, the
    'text "Search" is displayed.
    Private Sub SearchTB_LostFocus(ByVal sender As Object, ByVal e As RoutedEventArgs)
        If (SearchTB.Text = String.Empty) Then
            SearchTB.Text = "Search"
            Dim Brush2 As SolidColorBrush = New SolidColorBrush
            Brush2.Color = Colors.Blue
            SearchTB.Foreground = Brush2
        End If
    End Sub
End Class



public partial class Page : UserControl
{
    public Page()
    {
        InitializeComponent();
    }


    //The following method displays the text entered in ReadWriteTB in ReadOnlyTB.
    private void ReadWriteTB_TextChanged(object sender, RoutedEventArgs e)
    {
        ReadOnlyTB.Text = ReadWriteTB.Text;
    }

    //The foreground color of the text in SearchTB is set to Magenta when SearchTB
    //gets focus.
    private void SearchTB_GotFocus(object sender, RoutedEventArgs e)
    {
        SearchTB.Text = "";
        SolidColorBrush Brush1 = new SolidColorBrush();
        Brush1.Color = Colors.Magenta;
        SearchTB.Foreground = Brush1;

    }

    //The foreground color of the text in SearchTB is set to Blue when SearchTB
    //loses focus. Also, if SearchTB loses focus and no text is entered, the
    //text "Search" is displayed.
    private void SearchTB_LostFocus(object sender, RoutedEventArgs e)
    {
        if (SearchTB.Text == String.Empty)
        {
            SearchTB.Text = "Search";
            SolidColorBrush Brush2 = new SolidColorBrush();
            Brush2.Color = Colors.Blue;
            SearchTB.Foreground = Brush2;
        }
    }
}


Silverlight

受以下版本支持:5、4、3

Silverlight for Windows Phone

受以下版本支持:Windows Phone OS 7.1、Windows Phone OS 7.0

有关 Silverlight 支持的操作系统和浏览器的列表,请参见 支持的操作系统和浏览器

此类型的任何公共 static(在 Visual Basic 中为 Shared) 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

社区附加资源

添加
显示:
© 2015 Microsoft