SearchBar 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
用于提供搜索框的 View 控件。
public ref class SearchBar : Microsoft::Maui::Controls::InputView, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::SearchBar ^>, Microsoft::Maui::Controls::Internals::IFontElement, Microsoft::Maui::Controls::ISearchBarController, Microsoft::Maui::ISearchBar
public ref class SearchBar : Microsoft::Maui::Controls::InputView, Microsoft::Maui::Controls::IElementConfiguration<Microsoft::Maui::Controls::SearchBar ^>, Microsoft::Maui::Controls::ISearchBarController, Microsoft::Maui::ISearchBar
public class SearchBar : Microsoft.Maui.Controls.InputView, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.SearchBar>, Microsoft.Maui.Controls.Internals.IFontElement, Microsoft.Maui.Controls.ISearchBarController, Microsoft.Maui.ISearchBar
public class SearchBar : Microsoft.Maui.Controls.InputView, Microsoft.Maui.Controls.IElementConfiguration<Microsoft.Maui.Controls.SearchBar>, Microsoft.Maui.Controls.ISearchBarController, Microsoft.Maui.ISearchBar
type SearchBar = class
inherit InputView
interface ISearchBar
interface IView
interface IElement
interface ITransform
interface ITextInput
interface IText
interface ITextStyle
interface IPlaceholder
interface ITextAlignment
interface IFontElement
interface ISearchBarController
interface IElementConfiguration<SearchBar>
type 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 ITextAlignment
Public Class SearchBar
Inherits InputView
Implements IElementConfiguration(Of SearchBar), IFontElement, ISearchBar, ISearchBarController
Public 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 |
FontAttributes 属性的后备存储。 |
FontAutoScalingEnabledProperty |
用于提供搜索框的 View 控件。 |
FontFamilyProperty |
FontFamily 属性的后备存储。 |
FontSizeProperty |
FontSize 属性的后备存储。 |
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 |
用于提供搜索框的 View 控件。 (继承自 NavigableElement) |
ClassId |
获取或设置用于标识语义相似元素集合的值。 (继承自 Element) |
Clip |
指定元素的剪辑区域。 这是一种可绑定属性。 (继承自 VisualElement) |
CursorPosition |
用于提供搜索框的 View 控件。 |
CursorPosition |
获取或设置光标位置。 该值必须大于或等于 0 且小于或等于 的 Text长度。 这是一种可绑定属性。 (继承自 InputView) |
DesiredSize |
获取在布局流程的度量传递过程中此元素计算所得的大小。 (继承自 VisualElement) |
DisableLayout |
获取一个值,该值指示禁用此元素的布局。 (继承自 VisualElement) |
Dispatcher |
获取创建此可绑定对象时可用的调度程序,否则会尝试查找最接近的可用调度程序 (可能是窗口/应用的) 。 (继承自 BindableObject) |
EffectControlProvider |
供 .NET MAUI 内部使用。 (继承自 Element) |
Effects |
获取或设置将在运行时应用于 元素的样式和属性。 (继承自 Element) |
FlowDirection |
获取或设置布局流方向。 这是一种可绑定属性。 (继承自 VisualElement) |
FontAttributes |
获取用于指示搜索栏文本的字体是粗体、斜体还是两者皆否的值。 |
FontAttributes |
获取或设置一个值,该值指示此条目的文本字体是加粗、斜体还是两者均不加粗。 这是一种可绑定属性。 (继承自 InputView) |
FontAutoScalingEnabled |
用于提供搜索框的 View 控件。 |
FontAutoScalingEnabled |
确定此条目的字体是否应根据操作系统设置自动缩放。 默认值为 |
FontFamily |
获取或设置搜索框文本的字体系列。 |
FontFamily |
获取或设置此项文本的字体系列。 这是一种可绑定属性。 (继承自 InputView) |
FontSize |
获取该搜索栏中的文本字体大小。 |
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 控件。 |
IsEnabledCore |
此值表示累积 IsEnabled 值。 如果值将更改,重写此属性的所有类型还需要调用 RefreshIsEnabledProperty () 方法。 (继承自 VisualElement) |
IsFocused |
获取一个值,该值指示当前是否聚焦此元素。 这是一种可绑定属性。 (继承自 VisualElement) |
IsInPlatformLayout |
获取或设置一个值,该值指示此元素当前正在经历平台布局周期。 (继承自 VisualElement) |
IsLoaded |
指示元素是否连接到main对象树。 (继承自 VisualElement) |
IsPlatformEnabled |
获取或设置一个值,该值指示是否启用此元素的平台等效元素。 (继承自 VisualElement) |
IsPlatformStateConsistent |
获取或设置一个值,该值指示此元素当前与平台等效元素状态一致。 (继承自 VisualElement) |
IsReadOnly |
获取或设置指明是否应阻止用户修改文本的值。 默认为 |
IsSpellCheckEnabled |
获取或设置控制是否启用拼写检查的值。 (继承自 InputView) |
IsTextPredictionEnabled |
用于提供搜索框的 View 控件。 |
IsTextPredictionEnabled |
获取或设置一个值,该值控制是否启用文本预测和自动文本更正。 (继承自 InputView) |
IsVisible |
获取或设置一个值,该值确定此元素是否在屏幕上可见并占用布局中的空间。 这是一种可绑定属性。 (继承自 VisualElement) |
Keyboard |
获取或设置 InputView 的 Keyboard。 这是一种可绑定属性。 (继承自 InputView) |
LogicalChildren |
已过时.
供 Microsoft.Maui.Controls 平台内部使用。 (继承自 Element) |
Margin |
获取或设置视图的边距。 (继承自 View) |
MaximumHeightRequest |
获取或设置元素在布局期间将请求的最大高度。 这是一种可绑定属性。 (继承自 VisualElement) |
MaximumWidthRequest |
获取或设置元素在布局期间将请求的最大宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
MaxLength |
获取或设置允许的最大输入长度。 (继承自 InputView) |
MinimumHeightRequest |
获取或设置元素在布局期间将请求的最小高度。 这是一种可绑定属性。 (继承自 VisualElement) |
MinimumWidthRequest |
获取或设置元素在布局期间将请求的最小宽度。 这是一种可绑定属性。 (继承自 VisualElement) |
Navigation |
用于提供搜索框的 View 控件。 (继承自 NavigableElement) |
NavigationProxy |
用于提供搜索框的 View 控件。 (继承自 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 |
用于提供搜索框的 View 控件。 |
SelectionLength |
获取或设置所选内容的长度。 所选内容将从 开始 CursorPosition。 这是一种可绑定属性。 (继承自 InputView) |
Shadow |
获取或设置元素投射的阴影效果。 这是一种可绑定属性。 (继承自 VisualElement) |
Style |
用于提供搜索框的 View 控件。 (继承自 NavigableElement) |
StyleClass |
用于提供搜索框的 View 控件。 (继承自 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) |
方法
事件
显式接口实现
扩展方法
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈