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::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 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), 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() |
以指定的地理標記語言 (GML) 值為基礎建立新的 SearchBar 值 |
欄位
CancelButtonColorProperty |
的 CancelButtonColorBindable 屬性。 |
CharacterSpacingProperty |
提供搜尋方塊的 View 控制項。 |
ControlsSearchBarMapper |
已淘汰.
提供搜尋方塊的 View 控制項。 |
CursorPositionProperty |
的 CursorPositionBindable 屬性。 |
FontAttributesProperty |
提供搜尋方塊的 View 控制項。 |
FontAutoScalingEnabledProperty |
提供搜尋方塊的 View 控制項。 |
FontFamilyProperty |
提供搜尋方塊的 View 控制項。 |
FontSizeProperty |
提供搜尋方塊的 View 控制項。 |
HorizontalTextAlignmentProperty |
的 HorizontalTextAlignmentBindable 屬性。 |
IsTextPredictionEnabledProperty |
IsTextPredictionEnabled 屬性的備份存放區。 |
PlaceholderColorProperty |
PlaceholderColor 屬性的備份存放區。 |
PlaceholderProperty |
Placeholder 屬性的備份存放區。 |
propertyMapper |
表示檢視的內部 PropertyMapper。 (繼承來源 View) |
SearchCommandParameterProperty |
的 SearchCommandParameterBindable 屬性。 |
SearchCommandProperty |
的 SearchCommandBindable 屬性。 |
SelectionLengthProperty |
的 SelectionLengthBindable 屬性。 |
TextColorProperty |
TextColor 屬性的備份存放區。 |
TextProperty |
Text 屬性的備份存放區。 |
transientNamescope |
提供搜尋方塊的 View 控制項。 (繼承來源 Element) |
VerticalTextAlignmentProperty |
的 VerticalTextAlignmentBindable 屬性。 |
屬性
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 |
取得或設定值,指出由 Entry 顯示之文字中的字元之間應該有的裝置獨立單位數目。 適用於文字與預留位置。 (繼承來源 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 的鍵盤。 這是可繫結屬性。 (繼承來源 InputView) |
LogicalChildren |
已淘汰.
提供搜尋方塊的 View 控制項。 (繼承來源 Element) |
Margin |
取得或設定檢視的邊界。 (繼承來源 View) |
MaximumHeightRequest |
取得或設定元素在版面配置期間要求的最大高度。 這是可繫結屬性。 (繼承來源 VisualElement) |
MaximumWidthRequest |
取得或設定元素在版面配置期間要求的最大寬度。 這是可繫結屬性。 (繼承來源 VisualElement) |
MaxLength |
取得或設定錯誤回應的最大允許長度。 (繼承來源 InputView) |
MinimumHeightRequest |
取得或設定元素在版面配置期間要求的最低高度。 這是可繫結屬性。 (繼承來源 VisualElement) |
MinimumWidthRequest |
取得或設定元素在版面配置期間要求的最低寬度。 這是可繫結屬性。 (繼承來源 VisualElement) |
Navigation |
取得負責處理堆疊型瀏覽的物件。 (繼承來源 NavigableElement) |
NavigationProxy |
取得的NavigationProxy轉換Navigation。 (繼承來源 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) |