SearchBar 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
用于提供搜索框的 View 控件。
public ref class SearchBar : Microsoft::Maui::Controls::InputView, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::SearchBar ^>, Microsoft::Maui::Controls::ISearchBarController, Microsoft::Maui::ISearchBarpublic class SearchBar : Microsoft.Maui.Controls.InputView, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.SearchBar>, Microsoft.Maui.Controls.ISearchBarController, Microsoft.Maui.ISearchBartype SearchBar = class
inherit InputView
interface ISearchBarController
interface IElementConfiguration<SearchBar>
interface ISearchBar
interface IView
interface IElement
interface ITransform
interface ITextInput
interface IText
interface ITextStyle
interface IPlaceholder
interface ITextAlignmentPublic Class SearchBar
Inherits InputView
Implements IElementConfiguration(Of SearchBar), ISearchBar, ISearchBarController- 继承
- 实现
注解
下面的示例演示了基本用法。
public class App : Application
{
Label resultsLabel;
SearchBar searchBar;
public App ()
{
resultsLabel = new Label {
Text = "Result will appear here.",
VerticalOptions = LayoutOptions.FillAndExpand,
FontSize = 25
};
searchBar = new SearchBar {
Placeholder = "Enter search term",
SearchCommand = new Command(() => {resultsLabel.Text = "Result: " + searchBar.Text + " is what you asked for.";})
};
MainPage = new ContentPage {
Content = new StackLayout {
VerticalOptions = LayoutOptions.Start,
Children = {
new Label {
HorizontalTextAlignment = TextAlignment.Center,
Text = "SearchBar",
FontSize = 50
},
searchBar,
new ScrollView
{
Content = resultsLabel,
VerticalOptions = LayoutOptions.FillAndExpand
}
},
Padding = new Thickness(10, Device.OnPlatform(20, 0, 0), 10, 5)
}
};
}
// OnStart, OnSleep, and OnResume implementations, & etc.
}
构造函数
| SearchBar() |
创建新的 SearchBar。 |
字段
| CancelButtonColorProperty |
的可绑定属性 CancelButtonColor。 |
| CharacterSpacingProperty |
用于提供搜索框的 View 控件。 |
| ControlsSearchBarMapper |
已过时.
用于提供搜索框的 View 控件。 |
| CursorPositionProperty |
的可绑定属性 CursorPosition。 |
| FontAttributesProperty |
用于提供搜索框的 View 控件。 |
| FontAutoScalingEnabledProperty |
用于提供搜索框的 View 控件。 |
| FontFamilyProperty |
用于提供搜索框的 View 控件。 |
| FontSizeProperty |
用于提供搜索框的 View 控件。 |
| HorizontalTextAlignmentProperty |
的可绑定属性 HorizontalTextAlignment。 |
| IsTextPredictionEnabledProperty |
IsTextPredictionEnabled 属性的后备存储。 |
| PlaceholderColorProperty |
PlaceholderColor 属性的后备存储。 |
| PlaceholderProperty |
Placeholder 属性的后备存储。 |
| propertyMapper |
表示视图的内部 PropertyMapper。 (继承自 View) |
| SearchCommandParameterProperty |
的可绑定属性 SearchCommandParameter。 |
| SearchCommandProperty |
的可绑定属性 SearchCommand。 |
| SelectionLengthProperty |
的可绑定属性 SelectionLength。 |
| TextColorProperty |
TextColor 属性的后备存储。 |
| TextProperty |
Text 属性的后备存储。 |
| 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) |
| CancelButtonColor |
获取或设置取消按钮的颜色。 |
| CharacterSpacing |
获取或设置指明设备无关单位数的值，它应介于项显示的文本字符数之间。 适用于文本和占位符。 (继承自 InputView) |
| class |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
| Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
| CursorPosition |
获取或设置光标位置。 该值必须大于或等于 0 且小于或等于长度 Text。 这是一种可绑定属性。 (继承自 InputView) |
| DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
| DisableLayout |
获取一个值，该值指示此元素的布局已禁用。 (继承自 VisualElement) |
| Dispatcher |
获取创建此可绑定对象时可用的调度程序，否则会尝试查找最近的可用调度程序（可能是窗口的/应用）。 (继承自 BindableObject) |
| EffectControlProvider |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Effects |
获取或设置将在运行时应用于元素的样式和属性。 (继承自 Element) |
| FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
| FontAttributes |
获取或设置一个值，该值指示此条目的文本的字体是粗体、斜体还是两者都没有。 这是一种可绑定属性。 (继承自 InputView) |
| FontAutoScalingEnabled |
确定此条目的字体是否应根据操作系统设置自动缩放。 默认值是 |
| FontFamily |
获取或设置此条目的文本的字体系列。 这是一种可绑定属性。 (继承自 InputView) |
| FontSize |
获取或设置此条目文本的字体大小。 这是一种可绑定属性。 (继承自 InputView) |
| Frame |
获取或设置此元素驻留在屏幕上的框架。 (继承自 VisualElement) |
| GestureController |
用于提供搜索框的 View 控件。 (继承自 View) |
| GestureRecognizers |
与此视图关联的手势识别器的集合。 (继承自 View) |
| Handler |
获取或设置与此 IViewHandler 元素关联的项。 (继承自 VisualElement) |
| Height |
获取此元素的当前呈现高度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| HeightRequest |
获取或设置此元素的所需高度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| HorizontalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| HorizontalTextAlignment |
获取或设置水平文本对齐方式。 |
| Id |
获取一个值，该值可用于在应用程序运行过程中唯一标识元素。 (继承自 Element) |
| InputTransparent |
获取或设置一个值，该值指示此元素在用户交互期间是否响应命中测试。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabled |
获取或设置一个值，该值指示是否在用户界面中启用此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsEnabledCore |
用于提供搜索框的 View 控件。 |
| IsFocused |
获取一个值，该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
| IsInPlatformLayout |
获取或设置一个值，该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
| IsLoaded |
指示元素是否已连接到主对象树。 (继承自 VisualElement) |
| IsPlatformEnabled |
获取或设置一个值，该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
| IsPlatformStateConsistent |
获取或设置一个值，该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
| IsReadOnly |
获取或设置指明是否应阻止用户修改文本的值。 默认值为 |
| IsSpellCheckEnabled |
获取或设置控制是否启用拼写检查的值。 (继承自 InputView) |
| IsTextPredictionEnabled |
获取或设置一个值，该值控制是否启用文本预测和自动文本更正。 (继承自 InputView) |
| IsVisible |
获取或设置一个值，该值确定此元素在屏幕上是否可见，并在布局中占用空间。 这是一种可绑定属性。 (继承自 VisualElement) |
| Keyboard |
获取或设置 InputView 的 Keyboard。 这是一种可绑定属性。 (继承自 InputView) |
| LogicalChildren |
已过时.
用于提供搜索框的 View 控件。 (继承自 Element) |
| Margin |
获取或设置视图的边距。 (继承自 View) |
| MaximumHeightRequest |
获取或设置元素在布局期间请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaximumWidthRequest |
获取或设置元素在布局期间请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MaxLength |
获取或设置允许的最大输入长度。 (继承自 InputView) |
| MinimumHeightRequest |
获取或设置元素在布局期间请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
| MinimumWidthRequest |
获取或设置元素在布局期间请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
| Navigation |
获取负责处理基于堆栈的导航的对象。 (继承自 NavigableElement) |
| NavigationProxy |
获取转换为 Navigation . NavigationProxy. (继承自 NavigableElement) |
| Opacity |
获取或设置呈现元素时应用于元素的不透明度值。 此值的范围为 0 到 1;超出此范围的值将设置为最接近的有效值。 这是一种可绑定属性。 (继承自 VisualElement) |
| Parent |
获取或设置此元素的父 Element 级。 (继承自 Element) |
| Placeholder |
获取或设置在控件为空时显示的文本。 (继承自 InputView) |
| PlaceholderColor |
获取或设置占位符文本的颜色。 (继承自 InputView) |
| RealParent |
供 .NET MAUI 内部使用。 (继承自 Element) |
| Resources |
获取或设置本地资源字典。 (继承自 VisualElement) |
| Rotation |
获取或设置呈现元素时围绕 Z 轴（仿射旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationX |
获取或设置呈现元素时围绕 X 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| RotationY |
获取或设置呈现元素时围绕 Y 轴（透视旋转）的旋转角度（以度为单位）。 这是一种可绑定属性。 (继承自 VisualElement) |
| Scale |
获取或设置应用于元素的比例因子。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleX |
获取或设置要应用于 X 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| ScaleY |
获取或设置要应用于 Y 方向的缩放值。 这是一种可绑定属性。 (继承自 VisualElement) |
| SearchCommand |
获取或设置在用户按搜索按钮时运行的命令。 |
| SearchCommandParameter |
获取或设置发送到 SearchCommand 的参数。 |
| SelectionLength |
获取或设置所选内容的长度。 选择将从 CursorPosition. 这是一种可绑定属性。 (继承自 InputView) |
| Shadow |
获取或设置元素强制转换的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
| Style |
获取或设置此元素的唯 Style 一值。 (继承自 NavigableElement) |
| StyleClass |
获取或设置元素的样式类。 (继承自 NavigableElement) |
| StyleId |
获取或设置用于唯一地标识元素的用户定义的值。 (继承自 Element) |
| Text |
获取或设置输入视图的文本。 这是一种可绑定属性。 (继承自 InputView) |
| TextColor |
获取或设置文本颜色。 (继承自 InputView) |
| TextTransform |
用于提供搜索框的 View 控件。 (继承自 InputView) |
| TranslationX |
获取或设置元素的 X 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| TranslationY |
获取或设置元素的 Y 转换增量。 这是一种可绑定属性。 (继承自 VisualElement) |
| Triggers |
获取与此元素关联的对象列表 TriggerBase 。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| VerticalOptions |
获取或设置 LayoutOptions 定义元素在布局周期中布局的方式。 这是一种可绑定属性。 (继承自 View) |
| VerticalTextAlignment |
用于提供搜索框的 View 控件。 |
| Visual |
获取或设置替代 IVisual 元素的视觉外观的实现。 这是一种可绑定属性。 (继承自 VisualElement) |
| Width |
获取此元素的当前宽度。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| WidthRequest |
获取或设置此元素的所需宽度替代。 这是一种可绑定属性。 (继承自 VisualElement) |
| Window |
Window获取与元素关联的项。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| X |
获取此元素的当前 X 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| Y |
获取此元素的当前 Y 位置。 这是一种只读可绑定属性。 (继承自 VisualElement) |
| ZIndex |
获取或设置布局中元素的前向后 z 索引。 这是一种可绑定属性。 (继承自 VisualElement) |
