AutoSuggestBox 類別

定義

代表文字控制項,當使用者使用鍵盤或手寫筆 (使用筆跡和手寫辨識) 輸入文字時,向使用者提出建議。 當使用者變更文字時,應用程式會收到通知,並負責提供要顯示此控制項的相關建議。

public ref class AutoSuggestBox sealed : ItemsControl
/// [Microsoft.UI.Xaml.Controls.InputProperty(Name="Text")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AutoSuggestBox final : ItemsControl
[Microsoft.UI.Xaml.Controls.InputProperty(Name="Text")]
[Windows.Foundation.Metadata.Activatable(65536, "Microsoft.UI.Xaml.WinUIContract")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AutoSuggestBox : ItemsControl
Public NotInheritable Class AutoSuggestBox
Inherits ItemsControl
<AutoSuggestBox .../>
繼承
屬性

範例

提示

如需詳細資訊、設計指引和程式碼範例,請參閱 自動建議方塊

WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制項、特性和功能的互動式範例。 從Microsoft Store取得應用程式,或在GitHub上取得原始程式碼

若要查看 AutoSuggestBox 的完整運作範例,請參閱 AutoSuggestBox 移轉範例

下列程式碼示範具有必要事件處理常式的簡單 AutoSuggestBox。

<AutoSuggestBox PlaceholderText="Search" QueryIcon="Find" Width="200"
                TextChanged="AutoSuggestBox_TextChanged"
                QuerySubmitted="AutoSuggestBox_QuerySubmitted"
                SuggestionChosen="AutoSuggestBox_SuggestionChosen"/>
private void AutoSuggestBox_TextChanged(AutoSuggestBox sender, AutoSuggestBoxTextChangedEventArgs args)
{
    // Only get results when it was a user typing, 
    // otherwise assume the value got filled in by TextMemberPath 
    // or the handler for SuggestionChosen.
    if (args.Reason == AutoSuggestionBoxTextChangeReason.UserInput)
    {
        //Set the ItemsSource to be your filtered dataset
        //sender.ItemsSource = dataset;
    }
}


private void AutoSuggestBox_SuggestionChosen(AutoSuggestBox sender, AutoSuggestBoxSuggestionChosenEventArgs args)
{
    // Set sender.Text. You can use args.SelectedItem to build your text string.
}


private void AutoSuggestBox_QuerySubmitted(AutoSuggestBox sender, AutoSuggestBoxQuerySubmittedEventArgs args)
{
    if (args.ChosenSuggestion != null)
    {
        // User selected an item from the suggestion list, take an action on it here.
    }
    else
    {
        // Use args.QueryText to determine what to do.
    }
}

備註

提示

如需詳細資訊、設計指引和程式碼範例,請參閱 自動建議方塊

使用 AutoSuggestBox 提供讓使用者在輸入時可從中選取建議的清單。

文字輸入方塊預設不會顯示查詢按鈕。 您可以設定 QueryIcon 屬性,以便在文字方塊右側新增包含指定圖示的按鈕。 例如,若要讓 AutoSuggestBox 看起來像是典型的搜尋方塊,請加入「Find」圖示,就像這樣:

<AutoSuggestBox QueryIcon="Find"/>

以下是包含「尋找」圖示的 AutoSuggestBox。 建議清單會根據使用者的專案顯示建議的結果。

具有圖示和建議的自動建議方塊 若要使用 AutoSuggestBox,您需要回應 3 個使用者動作。
  • 變更文字 - 當使用者輸入文字時,更新建議清單。
  • 選擇建議 - 當使用者選擇建議清單中的建議時,更新文字方塊。
  • 提交查詢 - 當使用者提交查詢時,顯示查詢結果。

變更文字

每當更新文字方塊的內容時,就會發生 TextChanged 事件。 使用事件引數 Reason 屬性判斷變更是否因為使用者輸入所造成。 如果變更原因是 UserInput,請根據輸入,篩選您的資料。 接著,將已篩選的資料設定為 AutoSuggestBox 的 ItemsSource 以更新建議清單。

若要控制建議清單中顯示項目的方式,您可以使用 DisplayMemberPathItemTemplate

  • 若要顯示資料項目之單一屬性的文字,請將 DisplayMemberPath 屬性設定為從物件選擇要在建議清單中顯示的屬性。
  • 若要定義清單中每個專案的自訂外觀,請使用 ItemTemplate 屬性 。

選擇建議

當使用者使用鍵盤瀏覽建議清單時,您需要更新文字方塊中要符合的文字。

您可以設定 TextMemberPath 屬性以選擇您資料物件的哪個屬性要顯示在文字方塊中。 如果您指定 TextMemberPath,就會自動更新文字方塊。 您通常應該為 DisplayMemberPathTextMemberPath 指定相同的值,讓建議清單中的文字和文字方塊相同。

如果您需要顯示多個簡單的屬性,處理 SuggestionChosen 事件,以便根據選取的項目,將自訂文字填入文字方塊。

提交查詢

處理 QuerySubmitted 事件,以執行適合您應用程式的查詢動作,並向使用者顯示結果。

當使用者認可查詢字串時,就會發生 QuerySubmitted 事件。 使用者可以透過下列其中一種方式確認查詢:

  • 當焦點位於文字方塊中時,請按 Enter 鍵或按一下查詢圖示。 事件引數 ChosenSuggestion 屬性為 null
  • 當焦點位於建議清單中時,請按 Enter、按一下或點選項目。 事件引數 ChosenSuggestion 屬性包含從清單中選取的專案。 在所有情況下,事件引數 QueryText 屬性都會包含來自文字方塊的文字。

協助工具選項

如果您使用朗讀 程式等輔助技術來與 AutoSuggestBox 互動,協助工具體驗已為您連結。 使用者將會:

  • 在清單出現及清單關閉的時候知道
  • 知道有多少建議可用
  • 能將朗讀程式焦點移動到清單
  • 能夠透過所有其他閱讀模式流覽建議,如需詳細資訊,請參閱 自動建議協助工具

手寫筆輸入

從 Windows 10 版本 1803 開始,XAML 文字輸入方塊使用 Windows Ink 特別提供手寫筆輸入的內嵌支援。 當使用者使用 Windows 手寫筆點選文字輸入方塊時,文字方塊會改變形式,讓使用者使用手寫筆直接在其中書寫,而不是開啟另一個輸入面板。

您可以透過其 TextBox 控制項設定 AutoSuggestBox 的手寫檢視,如這裡所示。

<AutoSuggestBox Name="NoHandwritingAutoSuggestBox"
        BorderThickness="0"  Width="680"
        FontSize="24" VerticalAlignment="Top"
        HorizontalAlignment="Center"
        PlaceholderText="Handwriting view is not supported">
    <AutoSuggestBox.TextBoxStyle>
        <Style TargetType="TextBox">
            <Setter Property="IsHandwritingViewEnabled" Value="False"/>
        </Style>
    </AutoSuggestBox.TextBoxStyle>
</AutoSuggestBox>
使用筆跡與建議的文字方塊

如需詳細資訊,請參閱含手寫檢視的文字輸入

控制項樣式和範本

您可以修改預設 的 StyleControlTemplate ,讓控制項具有唯一的外觀。 如需修改控制項樣式和範本的相關資訊,請參閱 設定控制項的樣式。 定義控制面板的預設樣式、範本和資源會包含在 generic.xaml 檔案中。 為了設計目的,generic.xaml 可從 Windows 軟體發展工具組 (SDK (SDK) 安裝中的 (Program Files) \Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\ < SDK version > \Generic 資料夾取得。 不同 SDK 版本的樣式和資源可能會有不同的值。

從 Windows 10 版本 1607 (SDK 14393) 開始,generic.xaml 包含可用來修改不同視覺狀態中控制項色彩的資源,而不需修改控制項範本。 在以此軟體發展工具組為目標的應用程式 (SDK) 或更新版本中,最好修改這些資源來設定 背景前景等屬性。 如需詳細資訊,請參閱設定控制項樣式一文的輕量型樣式一節。

下表顯示 AutoSuggestBox 控制項所使用的資源。 以 「TextControl」 開頭的資源是由 TextBoxPasswordBoxRichEditBox和 AutoSuggestBox 共用。

資源索引鍵描述
AutoSuggestBoxSuggestionsListBackground建議清單的背景色彩
AutoSuggestBoxSuggestionsListBorderBrush建議清單的框線色彩
TextControlForeground待用文字色彩
TextControlForegroundPointerOver暫留時的文字色彩
TextControlForegroundFocused焦點時的文字色彩
TextControlForegroundDisabled停用時的文字色彩
TextControlBackground待用背景色彩
TextControlBackgroundPointerOver暫留時的背景色彩
TextControlBackgroundFocused焦點時的背景色彩
TextControlBackgroundDisabled停用時的背景色彩
TextControlBorderBrush待用框線色彩
TextControlBorderBrushPointerOver暫留時的框線色彩
TextControlBorderBrushFocused焦點時的框線色彩
TextControlBorderBrushDisabled停用時的框線色彩
TextControlPlaceholderForeground待用預留位置文字色彩
TextControlPlaceholderForegroundPointerOver暫留時預留位置文字色彩
TextControlPlaceholderForegroundFocused焦點時的預留位置文字色彩
TextControlPlaceholderForegroundDisabled停用時的預留位置文字色彩
TextControlHeaderForeground待用標頭文字色彩
TextControlHeaderForegroundDisabled停用時的標頭文字色彩
TextControlSelectionHighlightColor醒目提示選取文字的色彩
TextControlButtonBackground待用刪除按鈕的背景色彩
TextControlButtonBackgroundPointerOver暫留時刪除按鈕的背景色彩
TextControlButtonBackgroundPressed按下時刪除按鈕的背景色彩
TextControlButtonBorderBrush待用刪除按鈕的框線色彩
TextControlButtonBorderBrushPointerOver暫留時刪除按鈕的框線色彩
TextControlButtonBorderBrushPressed按下時刪除按鈕的框線色彩
TextControlButtonForeground待用刪除按鈕的前景色彩
TextControlButtonForegroundPointerOver暫留時刪除按鈕的前景色彩
TextControlButtonForegroundPressed按下時刪除按鈕的前景色彩

建構函式

AutoSuggestBox()

初始化 AutoSuggestBox 類別的新實例。

屬性

AccessKey

取得或設定這個專案的便捷鍵 (助憶鍵) 。

(繼承來源 UIElement)
AccessKeyScopeOwner

取得或設定來源專案,這個元素會提供這個專案的存取索引鍵範圍,即使它不在來源專案的視覺化樹狀結構中也一樣。

(繼承來源 UIElement)
ActualHeight

取得 FrameworkElement的呈現高度。 請參閱<備註>。

(繼承來源 FrameworkElement)
ActualOffset

取得這個 UIElement 的位置,相對於其父系,在配置程式的排列階段期間計算。

(繼承來源 UIElement)
ActualSize

取得這個 UIElement 在配置程式的排列階段期間計算的大小。

(繼承來源 UIElement)
ActualTheme

取得專案目前使用的 UI 主題,可能與 RequestedTheme不同。

(繼承來源 FrameworkElement)
ActualWidth

取得 FrameworkElement的呈現寬度。 請參閱<備註>。

(繼承來源 FrameworkElement)
AllowDrop

取得或設定值,這個值會判斷這個 UIElement 是否可以是拖放作業的置放目標。

(繼承來源 UIElement)
AllowFocusOnInteraction

取得或設定值,這個值表示當使用者與其互動時,專案是否會自動取得焦點。

(繼承來源 FrameworkElement)
AllowFocusWhenDisabled

取得或設定停用的控制項是否可以接收焦點。

(繼承來源 FrameworkElement)
AutoMaximizeSuggestionArea

指出建議區域是否應該自動最大化。

AutoMaximizeSuggestionAreaProperty

識別 AutoMaximizeSuggestionArea 相依性屬性。

Background

取得或設定提供 控制項背景的筆刷。

(繼承來源 Control)
BackgroundSizing

取得或設定值,這個值表示背景相對於這個專案框線的延伸程度。

(繼承來源 Control)
BaseUri

取得統一資源識別元 (URI) ,代表 XAML 載入時間 XAML 建構物件的基底 URI。 此屬性適用于執行時間的 URI 解析。

(繼承來源 FrameworkElement)
BorderBrush

取得或設定描述控制項框線填滿的筆刷。

(繼承來源 Control)
BorderThickness

取得或設定控制項的框線粗細。

(繼承來源 Control)
CacheMode

取得或設定值,這個值表示轉譯的內容應該盡可能快取為複合點陣圖。

(繼承來源 UIElement)
CanBeScrollAnchor

取得或設定值,這個值表示 UIElement 是否可以是捲動錨定候選項目。

(繼承來源 UIElement)
CanDrag

取得或設定值,這個值表示是否可以將專案拖曳為拖放作業中的資料。

(繼承來源 UIElement)
CenterPoint

取得或設定專案的中心點,這是發生旋轉或縮放的點。 影響專案的轉譯位置。

(繼承來源 UIElement)
CharacterSpacing

取得或設定字元之間的統一間距,單位為 em 的 1/1000。

(繼承來源 Control)
Clip

取得或設定用來定義UIElement內容的大綱的RectangleGeometry

(繼承來源 UIElement)
CompositeMode

取得或設定屬性,這個屬性會宣告其父版面配置和視窗中專案的替代組合和混合模式。 這與混合 XAML/Microsoft DirectX UI 相關的元素相關。

(繼承來源 UIElement)
ContextFlyout

取得或設定與這個專案相關聯的飛出視窗。

(繼承來源 UIElement)
CornerRadius

取得或設定控制項框線角落的半徑。

(繼承來源 Control)
DataContext

取得或設定 FrameworkElement的資料內容。 資料內容的常見用法是當 FrameworkElement 使用 {Binding} 標記延伸並參與資料系結時。

(繼承來源 FrameworkElement)
DefaultStyleKey

取得或設定參考控制項預設樣式的索引鍵。 自訂控制項的作者會使用此屬性來變更其控制項所使用的樣式預設值。

(繼承來源 Control)
DefaultStyleResourceUri

取得或設定資源檔的路徑,其中包含控制項的預設樣式。

(繼承來源 Control)
Description

取得或設定控制項下方顯示的內容。 內容應該提供控制項預期之輸入的指引。

DescriptionProperty

識別 Description 相依性屬性。

DesiredSize

取得這個 UIElement 在版面配置程式的量值階段期間計算的大小。

(繼承來源 UIElement)
Dispatcher

取得與此物件相關聯的 CoreDispatcherCoreDispatcher代表可以存取 UI 執行緒上DependencyObject的功能,即使程式碼是由非 UI 執行緒起始也一樣。

(繼承來源 DependencyObject)
DispatcherQueue

DispatcherQueue取得與這個 物件相關聯的 。 DispatcherQueue表示即使程式碼是由非 UI 執行緒起始,也可以存取 DependencyObject UI 執行緒上的 。

(繼承來源 DependencyObject)
DisplayMemberPath

取得或設定每個資料項目所顯示之屬性的名稱或路徑。

(繼承來源 ItemsControl)
ElementSoundMode

取得或設定值,指定是否播放音效的控制項喜好設定。

(繼承來源 Control)
ExitDisplayModeOnAccessKeyInvoked

取得或設定值,指定叫用存取金鑰時是否關閉存取金鑰顯示。

(繼承來源 UIElement)
FlowDirection

取得或設定文字和其他 UI 元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 LeftToRightRightToLeftRightToLeft在任何 FlowDirection 元素上設定為 ,會將對齊方式設定為右邊、從右至左的讀取順序,以及從右至左流動之控制項的配置。

(繼承來源 FrameworkElement)
FocusState

取得值,指定這個控制項是否有焦點,以及取得焦點的模式。

(繼承來源 UIElement)
FocusVisualMargin

取得或設定 FrameworkElement焦點視覺效果的外部邊界。

(繼承來源 FrameworkElement)
FocusVisualPrimaryBrush

取得或設定筆刷,用來繪製FrameworkElement之或 Reveal 焦點視覺效果的外部 HighVisibility 框線。

(繼承來源 FrameworkElement)
FocusVisualPrimaryThickness

取得或設定FrameworkElement之外部 Reveal 框線的 HighVisibility 粗細。

(繼承來源 FrameworkElement)
FocusVisualSecondaryBrush

取得或設定筆刷,用來繪製FrameworkElement之或 Reveal 焦點視覺效果的內部 HighVisibility 框線。

(繼承來源 FrameworkElement)
FocusVisualSecondaryThickness

取得或設定FrameworkElementHighVisibilityReveal 焦點視覺效果的內部框線粗細。

(繼承來源 FrameworkElement)
FontFamily

取得或設定顯示控制項的文字所用的字型。

(繼承來源 Control)
FontSize

取得或設定這個控制項中的文字大小。

(繼承來源 Control)
FontStretch

取得或設定螢幕上字型緊縮或加寬的程度。

(繼承來源 Control)
FontStyle

取得或設定轉譯文字的樣式。

(繼承來源 Control)
FontWeight

取得或設定指定字型的粗細。

(繼承來源 Control)
Foreground

取得或設定描述前景色彩的筆刷。

(繼承來源 Control)
GroupStyle

取得 GroupStyle 物件的集合,定義每個群組層級的外觀。

(繼承來源 ItemsControl)
GroupStyleSelector

取得或設定自訂 GroupStyleSelector 邏輯類別的參考。 GroupStyleSelector會根據該內容的特性傳回不同的GroupStyle值,以用於內容。

(繼承來源 ItemsControl)
Header

取得或設定這個控制項文字方塊部分的標頭物件。

HeaderProperty

識別 標頭 相依性屬性。

Height

取得或設定 FrameworkElement的建議高度。

(繼承來源 FrameworkElement)
HighContrastAdjustment

取得或設定值,這個值表示當啟用高對比主題時,架構是否會自動調整專案的視覺屬性。

(繼承來源 UIElement)
HorizontalAlignment

取得或設定在版面配置父系中撰寫時套用至 FrameworkElement 的水準對齊特性,例如面板或專案控制項。

(繼承來源 FrameworkElement)
HorizontalContentAlignment

取得或設定控制項內容的水平對齊。

(繼承來源 Control)
IsAccessKeyScope

取得或設定值,這個值表示專案是否定義自己的存取金鑰範圍。

(繼承來源 UIElement)
IsDoubleTapEnabled

取得或設定值,這個值會判斷 DoubleTapped 事件是否可以來自該專案。

(繼承來源 UIElement)
IsEnabled

取得或設定值,指出使用者是否可以與控制項互動。

(繼承來源 Control)
IsFocusEngaged

取得或設定值,指出當使用者按下 Xbox 控制器上的 A/Select 按鈕時,焦點是否受限於控制項。

(繼承來源 Control)
IsFocusEngagementEnabled

取得或設定值,指出當使用者按下 Xbox 控制器上的 A/Select 按鈕時,焦點是否可以限制為控制項。

(繼承來源 Control)
IsGrouping

取得指出控制項是否使用群組的值。

(繼承來源 ItemsControl)
IsHitTestVisible

取得或設定這個 UIElement 的自主區域是否可以傳回真正的值來進行點擊測試。

(繼承來源 UIElement)
IsHoldingEnabled

取得或設定值,這個值會決定 Holding 事件是否可以來自該專案。

(繼承來源 UIElement)
IsLoaded

取得值,這個值表示專案是否已加入至專案樹狀結構,且已準備好進行互動。

(繼承來源 FrameworkElement)
IsRightTapEnabled

取得或設定值,這個值會判斷 RightTapped 事件是否可以來自該專案。

(繼承來源 UIElement)
IsSuggestionListOpen

取得或設定 Boolean 值,指出 AutoSuggestBox 的下拉式部分是否開啟。

IsSuggestionListOpenProperty

識別 IsSuggestionListOpen 相依性屬性。

IsTabStop

取得或設定值,這個值表示控制項是否包含於索引標籤巡覽。

(繼承來源 UIElement)
IsTapEnabled

取得或設定值,這個值會決定 Tapped 事件是否可以來自該專案。

(繼承來源 UIElement)
IsTextScaleFactorEnabled

取得或設定是否啟用自動放大文字,以反映系統文字大小設定。

(繼承來源 Control)
ItemContainerGenerator

取得與此ItemsControl相關聯的ItemContainerGenerator

(繼承來源 ItemsControl)
ItemContainerStyle

取得或設定呈現 ItemsControl之專案容器時所使用的樣式。

(繼承來源 ItemsControl)
ItemContainerStyleSelector

取得或設定自訂 StyleSelector 邏輯類別的參考。 StyleSelector會根據所顯示物件的特性,傳回要用於專案容器的不同Style值。

(繼承來源 ItemsControl)
ItemContainerTransitions

取得或設定 Transition 樣式專案的集合,這些專案會套用至 ItemsControl的專案容器。

(繼承來源 ItemsControl)
Items

取得用來產生控制項內容的集合。

(繼承來源 ItemsControl)
ItemsPanel

取得或設定樣板,這個樣板會定義控制項目配置的面板。

(繼承來源 ItemsControl)
ItemsPanelRoot

取得ItemsPanel指定的Panel

(繼承來源 ItemsControl)
ItemsSource

取得或設定用來產生 ItemsControl內容的物件來源。

(繼承來源 ItemsControl)
ItemTemplate

取得或設定用來顯示每個專案的 DataTemplate

(繼承來源 ItemsControl)
ItemTemplateSelector

取得或設定自訂 DataTemplateSelector 邏輯類別的參考。 此屬性所參考 的 DataTemplateSelector 會傳回要套用至專案的範本。

(繼承來源 ItemsControl)
KeyboardAcceleratorPlacementMode

取得或設定值,這個值表示控制項 工具提示 是否顯示其相關聯的鍵盤快速鍵組合。

(繼承來源 UIElement)
KeyboardAcceleratorPlacementTarget

取得或設定值,這個值表示顯示快速鍵組合的控制項 工具提示

(繼承來源 UIElement)
KeyboardAccelerators

取得使用鍵盤叫用動作的按鍵組合集合。

快速鍵通常會指派給按鈕或功能表項目。

顯示各種功能表項目鍵盤快速鍵的功能表範例
顯示各種功能表項目鍵盤快速鍵的功能表範例

(繼承來源 UIElement)
KeyTipHorizontalOffset

取得或設定值,指出索引鍵提示相對於 UIElement 的左邊或右邊。

(繼承來源 UIElement)
KeyTipPlacementMode

取得或設定值,這個值表示存取索引鍵提示相對於 UIElement 界限的位置。

(繼承來源 UIElement)
KeyTipTarget

取得或設定值,這個值表示存取索引鍵提示的目標專案。

(繼承來源 UIElement)
KeyTipVerticalOffset

取得或設定值,這個值表示相對於 UI 元素放置索引鍵提示的上下距離。

(繼承來源 UIElement)
Language

取得或設定套用至 FrameworkElement的當地語系化/全球化語言資訊,以及套用至物件標記法和 UI 中目前 FrameworkElement 的所有子項目。

(繼承來源 FrameworkElement)
LightDismissOverlayMode

取得或設定值,這個值會指定 淺色關閉 UI 外部的區域是否變深。

LightDismissOverlayModeProperty

識別 LightDismissOverlayMode 相依性屬性。

Lights

取得附加至這個專案的 XamlLight 物件集合。

(繼承來源 UIElement)
ManipulationMode

取得或設定用於UIElement行為與手勢互動的ManipulationModes值。 設定此值可讓您處理來自應用程式程式碼中這個專案的操作事件。

(繼承來源 UIElement)
Margin

取得或設定 FrameworkElement的外部邊界。

(繼承來源 FrameworkElement)
MaxHeight

取得或設定 FrameworkElement的最大高度條件約束。

(繼承來源 FrameworkElement)
MaxSuggestionListHeight

取得或設定 AutoSuggestBox 控制項下拉式部分的最大高度。

MaxSuggestionListHeightProperty

識別 MaxSuggestionListHeight 相依性屬性。

MaxWidth

取得或設定 FrameworkElement的最大寬度條件約束。

(繼承來源 FrameworkElement)
MinHeight

取得或設定 FrameworkElement的最小高度條件約束。

(繼承來源 FrameworkElement)
MinWidth

取得或設定 FrameworkElement的最小寬度條件約束。

(繼承來源 FrameworkElement)
Name

取得或設定 物件的識別名稱。 當 XAML 處理器從 XAML 標記建立物件樹狀結構時,執行時間程式碼可以透過這個名稱參考 XAML 宣告的物件。

(繼承來源 FrameworkElement)
Opacity

取得或設定物件的不透明度程度。

(繼承來源 UIElement)
OpacityTransition

取得或設定 ScalarTransition,以動畫顯示 Opacity 屬性的變更。

(繼承來源 UIElement)
Padding

取得或設定控制項內部的邊框間距。

(繼承來源 Control)
Parent

取得物件樹狀結構中這個 FrameworkElement 的父物件。

(繼承來源 FrameworkElement)
PlaceholderText

取得或設定要顯示在 控制項中的預留位置文字。

PlaceholderTextProperty

識別 PlaceholderText 相依性屬性。

PointerCaptures

取得所有擷取的指標集合,表示為 Pointer 值。

(繼承來源 UIElement)
Projection

取得或設定轉譯這個專案時要套用 (立體效果) 的透視投影。

(繼承來源 UIElement)
ProtectedCursor

取得或設定指標位於這個專案上方時所顯示的游標。 預設為 null,表示資料指標沒有變更。

(繼承來源 UIElement)
QueryIcon

取得或設定按一下以起始查詢之按鈕的圖形內容。

QueryIconProperty

識別 QueryIcon 相依性屬性。

RasterizationScale

代表文字控制項,當使用者使用鍵盤或手寫筆 (使用筆跡和手寫辨識) 輸入文字時,向使用者提出建議。 當使用者變更文字時,應用程式會收到通知,並負責提供要顯示此控制項的相關建議。

(繼承來源 UIElement)
RenderSize

取得 UIElement的最終轉譯大小。 不建議使用,請參閱。

(繼承來源 UIElement)
RenderTransform

取得或設定會影響 UIElement轉譯位置的轉換資訊。

(繼承來源 UIElement)
RenderTransformOrigin

取得或設定 RenderTransform所宣告之任何可能轉譯轉換的原點,相對於 UIElement的界限。

(繼承來源 UIElement)
RequestedTheme

取得或設定 UIElement (及其子項目) 用於資源判斷的 UI 主題。 您指定的 RequestedTheme UI 主題可以覆寫應用層級 RequestedTheme

(繼承來源 FrameworkElement)
RequiresPointer

取得或設定 UI 元素是否支援滑鼠模式,以模擬非指標輸入裝置的指標互動體驗,例如鍵盤或 Xbox 控制器。

(繼承來源 Control)
Resources

取得本機定義的資源字典。 在 XAML 中,您可以透過 XAML 隱含集合語法,將資源專案建立為屬性專案的子物件專案 frameworkElement.Resources

(繼承來源 FrameworkElement)
Rotation

取得或設定順時針旋轉的角度,以度為單位。 相對於 RotationAxis 和 CenterPoint 旋轉。 影響專案的轉譯位置。

(繼承來源 UIElement)
RotationAxis

取得或設定要繞著專案旋轉的軸。

(繼承來源 UIElement)
RotationTransition

取得或設定 ScalarTransition,以動畫顯示 Rotation 屬性的變更。

(繼承來源 UIElement)
Scale

取得或設定專案的小數位數。 相對於專案的 CenterPoint 縮放比例。 影響專案的轉譯位置。

(繼承來源 UIElement)
ScaleTransition

取得或設定 Vector3Transition,以動畫顯示 Scale 屬性的變更。

(繼承來源 UIElement)
Shadow

取得或設定 專案所轉換的陰影效果。

(繼承來源 UIElement)
Style

取得或設定配置和轉譯期間針對這個物件套用的實例 Style

(繼承來源 FrameworkElement)
TabFocusNavigation

取得或設定值,這個值會修改 Tabbing 和 TabIndex 對此控制項的運作方式。

(繼承來源 UIElement)
TabIndex

取得或設定值,這個值會決定當使用者使用 Tab 鍵巡覽控制項時,元素接收焦點的順序。

(繼承來源 UIElement)
TabNavigation

取得或設定值,這個值會修改 Tabbing 和 UIElement.TabIndex 對此控制項的運作方式。

注意

針對Windows 10 Creators Update (組建 10.0.15063) 和更新版本,TABFocusNavigation屬性可在UIElement基類上使用,以在不使用ControlTemplate的索引標籤序列中包含物件。

(繼承來源 Control)
Tag

取得或設定任意物件值,可用來儲存這個物件的自訂資訊。

(繼承來源 FrameworkElement)
Template

取得或設定控制項範本。 控制項範本會定義 UI 中控制項的視覺外觀,並在 XAML 標記中定義。

(繼承來源 Control)
Text

取得或設定 控制項中顯示的文字。

TextBoxStyle

取得或設定自動建議文字方塊的樣式。

TextBoxStyleProperty

識別 TextBoxStyle 相依性屬性。

TextMemberPath

取得或設定屬性路徑,用於在選取專案時,取得 AutoSuggestBox 控制項文字方塊部分中顯示的值。

TextMemberPathProperty

識別 TextMemberPath 相依性屬性。

TextProperty

識別 PlaceholderText 相依性屬性。

Transform3D

取得或設定轉譯這個專案時要套用的 3D 轉換效果。

(繼承來源 UIElement)
TransformMatrix

取得或設定要套用至專案的轉換矩陣。

(繼承來源 UIElement)
Transitions

取得或設定套用至UIElementTransition樣式專案集合。

(繼承來源 UIElement)
Translation

取得或設定專案的 x、y 和 z 轉譯位置。

(繼承來源 UIElement)
TranslationTransition

取得或設定 Vector3Transition,以動畫顯示 Translation 屬性的變更。

(繼承來源 UIElement)
Triggers

取得針對 FrameworkElement定義的動畫觸發程式集合。 不常使用。 請參閱<備註>。

(繼承來源 FrameworkElement)
UpdateTextOnSelect

TextMemberPath搭配使用,取得或設定值,指出檢視中的專案是否會在按一下時觸發 AutoSuggestBox 的可編輯文字部分更新。

UpdateTextOnSelectProperty

識別 UpdateTextOnSelect 相依性屬性。

UseLayoutRounding

取得或設定值,這個值會判斷物件及其視覺子樹的轉譯是否應該使用四捨五入行為,將轉譯對齊整個圖元。

(繼承來源 UIElement)
UseSystemFocusVisuals

取得或設定值,這個值表示控制項是否使用由控制項範本中定義的系統或焦點視覺效果所繪製的焦點視覺效果。

(繼承來源 UIElement)
VerticalAlignment

取得或設定在面板或專案控制項等父物件中撰寫時套用至 FrameworkElement 的垂直對齊特性。

(繼承來源 FrameworkElement)
VerticalContentAlignment

取得或設定控制項內容的垂直對齊。

(繼承來源 Control)
Visibility

取得或設定 UIElement的可見度。 UIElement未顯示且不會將其所需的大小傳達給版面配置。

(繼承來源 UIElement)
Width

取得或設定 FrameworkElement的寬度。

(繼承來源 FrameworkElement)
XamlRoot

取得或設定正在檢視這個專案的 XamlRoot。

(繼承來源 UIElement)
XYFocusDown

取得或設定物件,當使用者按下 Xbox 控制器的 Directional Pad (D-pad) 時取得焦點。

(繼承來源 UIElement)
XYFocusDownNavigationStrategy

取得或設定值,指定用來判斷向下流覽之目標元素的策略。

(繼承來源 UIElement)
XYFocusKeyboardNavigation

取得或設定值,這個值會啟用或停用使用鍵盤方向箭號的流覽。

(繼承來源 UIElement)
XYFocusLeft

取得或設定物件,當使用者在 Xbox 控制器的 Directional Pad (D 鍵) 左鍵時取得焦點。

(繼承來源 UIElement)
XYFocusLeftNavigationStrategy

取得或設定值,指定用來判斷左側導覽之目標元素的策略。

(繼承來源 UIElement)
XYFocusRight

取得或設定物件,當使用者在 Xbox 控制器的 Directional Pad (D-pad) 上按下滑鼠右鍵時取得焦點。

(繼承來源 UIElement)
XYFocusRightNavigationStrategy

取得或設定值,指定用來判斷右導覽之目標元素的策略。

(繼承來源 UIElement)
XYFocusUp

取得或設定物件,當使用者按下 Xbox 控制器的 Directional Pad (D-pad) 時取得焦點。

(繼承來源 UIElement)
XYFocusUpNavigationStrategy

取得或設定值,指定用來判斷向上流覽之目標元素的策略。

(繼承來源 UIElement)

方法

AddHandler(RoutedEvent, Object, Boolean)

加入所指定路由事件的路由事件處理常式,會將此處理常式加入目前項目的處理常式集合中。 指定 handledEventsTootrue ,即使事件是在其他地方處理,仍要叫用提供的處理常式。

(繼承來源 UIElement)
ApplyTemplate()

載入相關的控制項範本,以便參考其元件。

(繼承來源 Control)
Arrange(Rect)

放置子物件,並決定 UIElement的大小。 為其子專案實作自訂配置的父物件應該從其版面配置覆寫實作呼叫此方法,以形成遞迴版面配置更新。

(繼承來源 UIElement)
ArrangeOverride(Size)

提供配置「排列」傳遞的行為。 類別可以覆寫這個方法,以定義自己的「排列」傳遞行為。

(繼承來源 FrameworkElement)
CancelDirectManipulations()

取消任何包含目前UIElementScrollViewer父代上 (系統定義的移動流覽/縮放) 進行中的直接操作處理。

(繼承來源 UIElement)
CapturePointer(Pointer)

設定 UIElement的指標擷取。 擷取之後,只有具有擷取的專案才會引發指標相關事件。

(繼承來源 UIElement)
ClearContainerForItemOverride(DependencyObject, Object)

復原 PrepareContainerForItemOverride 方法的效果。

(繼承來源 ItemsControl)
ClearValue(DependencyProperty)

清除相依性屬性的本機值。

(繼承來源 DependencyObject)
ContainerFromIndex(Int32)

傳回 ItemCollection內指定索引處之專案的容器。

(繼承來源 ItemsControl)
ContainerFromItem(Object)

傳回對應至指定專案的容器。

(繼承來源 ItemsControl)
FindName(String)

擷取具有指定識別碼名稱的物件。

(繼承來源 FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)

可讓 UIElement 子類別公開可協助解決觸控目標的子項目。

(繼承來源 UIElement)
Focus(FocusState)

嘗試將焦點設定至此項目。

(繼承來源 UIElement)
GetAnimationBaseValue(DependencyProperty)

傳回針對相依性屬性所建立的任何基底值,如果動畫未使用中,則會套用。

(繼承來源 DependencyObject)
GetBindingExpression(DependencyProperty)

會傳回代表指定屬性上系結的 BindingExpression

(繼承來源 FrameworkElement)
GetChildrenInTabFocusOrder()

可讓 UIElement 子類別公開參與 Tab 焦點的子項目。

(繼承來源 UIElement)
GetContainerForItemOverride()

建立或識別用來顯示指定項目的項目。

(繼承來源 ItemsControl)
GetTemplateChild(String)

擷取具現化 ControlTemplate 視覺化樹狀結構中的具名專案。

(繼承來源 Control)
GetValue(DependencyProperty)

DependencyObject傳回相依性屬性的目前有效值。

(繼承來源 DependencyObject)
GetVisualInternal()

Visual 取專案解析為 的 。

(繼承來源 UIElement)
GoToElementStateCore(String, Boolean)

在衍生類別中實作時,可在程式碼中針對控制項範本啟用每個狀態的視覺化樹狀結構建構,而不是在控制項啟動時載入所有狀態的 XAML。

(繼承來源 FrameworkElement)
GroupHeaderContainerFromItemContainer(DependencyObject)

傳回對應至指定之容器專案的群組標頭容器。

(繼承來源 ItemsControl)
IndexFromContainer(DependencyObject)

將索引傳回至具有指定之產生的容器的專案。

(繼承來源 ItemsControl)
InvalidateArrange()

使 UIElement的排列狀態 (配置) 失效。 無效之後, UIElement 會更新其版面配置,這會以非同步方式發生。

(繼承來源 UIElement)
InvalidateMeasure()

使 UIElement的度量狀態 (配置) 失效。

(繼承來源 UIElement)
InvalidateViewport()

使用來計算有效檢視區的UIElement檢視區狀態失效。

(繼承來源 FrameworkElement)
IsItemItsOwnContainerOverride(Object)

判斷指定的專案是否 (或有資格) 自己的容器。

(繼承來源 ItemsControl)
ItemFromContainer(DependencyObject)

傳回對應至指定之產生的容器的專案。

(繼承來源 ItemsControl)
Measure(Size)

更新UIElementDesiredSize。 一般而言,針對其版面配置子系實作實作自訂配置的物件,會從自己的 MeasureOverride 實作呼叫這個方法,以形成遞迴版面配置更新。

(繼承來源 UIElement)
MeasureOverride(Size)

提供配置週期的「量值」傳遞行為。 類別可以覆寫這個方法,以定義自己的「量值」傳遞行為。

(繼承來源 FrameworkElement)
OnApplyTemplate()

每當應用程式程式碼或內部進程 (,例如重建版面配置傳遞) 呼叫 ApplyTemplate時叫用。 在最簡單的詞彙中,這表示方法只會在應用程式中顯示 UI 元素之前呼叫。 覆寫這個方法,以影響類別的預設範本後邏輯。

(繼承來源 FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)

在 BringIntoViewRequested事件發生之前呼叫。

(繼承來源 UIElement)
OnCharacterReceived(CharacterReceivedRoutedEventArgs)

在 CharacterReceived事件發生之前呼叫。

(繼承來源 Control)
OnCreateAutomationPeer()

在衍生類別中實作時,會傳回 Microsoft 消費者介面自動化 基礎結構的類別特定AutomationPeer實作。

(繼承來源 UIElement)
OnDisconnectVisualChildren()

覆寫這個方法,以實作從類別特定內容或子屬性移除專案時配置和邏輯的行為。

(繼承來源 UIElement)
OnDoubleTapped(DoubleTappedRoutedEventArgs)

DoubleTapped 事件發生之前呼叫。

(繼承來源 Control)
OnDragEnter(DragEventArgs)

發生 DragEnter 事件之前呼叫。

(繼承來源 Control)
OnDragLeave(DragEventArgs)

DragLeave 事件發生之前呼叫。

(繼承來源 Control)
OnDragOver(DragEventArgs)

DragOver 事件發生之前呼叫。

(繼承來源 Control)
OnDrop(DragEventArgs)

Drop 事件發生之前呼叫。

(繼承來源 Control)
OnGotFocus(RoutedEventArgs)

GotFocus 事件發生之前呼叫。

(繼承來源 Control)
OnGroupStyleSelectorChanged(GroupStyleSelector, GroupStyleSelector)

GroupStyleSelector 屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnHolding(HoldingRoutedEventArgs)

在 Holding事件發生之前呼叫。

(繼承來源 Control)
OnItemContainerStyleChanged(Style, Style)

ItemContainerStyle 屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnItemContainerStyleSelectorChanged(StyleSelector, StyleSelector)

ItemContainerStyleSelector 屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnItemsChanged(Object)

Items 屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnItemTemplateChanged(DataTemplate, DataTemplate)

當 ItemTemplate屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnItemTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

ItemTemplateSelector 屬性的值變更時叫用。

(繼承來源 ItemsControl)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)

在應用程式中處理 鍵盤快速鍵 (或快速鍵) 時呼叫。 覆寫這個方法,以處理叫用鍵盤快速鍵時您的應用程式回應方式。

(繼承來源 UIElement)
OnKeyDown(KeyRoutedEventArgs)

在 KeyDown事件發生之前呼叫。

(繼承來源 Control)
OnKeyUp(KeyRoutedEventArgs)

在 KeyUp事件發生之前呼叫。

(繼承來源 Control)
OnLostFocus(RoutedEventArgs)

LostFocus 事件發生之前呼叫。

(繼承來源 Control)
OnManipulationCompleted(ManipulationCompletedRoutedEventArgs)

ManipulationCompleted 事件發生之前呼叫。

(繼承來源 Control)
OnManipulationDelta(ManipulationDeltaRoutedEventArgs)

ManipulationDelta 事件發生之前呼叫。

(繼承來源 Control)
OnManipulationInertiaStarting(ManipulationInertiaStartingRoutedEventArgs)

ManipulationInertiaStarting 事件發生之前呼叫。

(繼承來源 Control)
OnManipulationStarted(ManipulationStartedRoutedEventArgs)

ManipulationStarted 事件發生之前呼叫。

(繼承來源 Control)
OnManipulationStarting(ManipulationStartingRoutedEventArgs)

ManipulationStarting 事件發生之前呼叫。

(繼承來源 Control)
OnPointerCanceled(PointerRoutedEventArgs)

PointerCanceled 事件發生之前呼叫。

(繼承來源 Control)
OnPointerCaptureLost(PointerRoutedEventArgs)

PointerCaptureLost 事件發生之前呼叫。

(繼承來源 Control)
OnPointerEntered(PointerRoutedEventArgs)

PointerEntered 事件發生之前呼叫。

(繼承來源 Control)
OnPointerExited(PointerRoutedEventArgs)

PointerExited 事件發生之前呼叫。

(繼承來源 Control)
OnPointerMoved(PointerRoutedEventArgs)

PointerMoved 事件發生之前呼叫。

(繼承來源 Control)
OnPointerPressed(PointerRoutedEventArgs)

PointerPressed 事件發生之前呼叫。

(繼承來源 Control)
OnPointerReleased(PointerRoutedEventArgs)

PointerReleased 事件發生之前呼叫。

(繼承來源 Control)
OnPointerWheelChanged(PointerRoutedEventArgs)

PointerWheelChanged 事件發生之前呼叫。

(繼承來源 Control)
OnPreviewKeyDown(KeyRoutedEventArgs)

PreviewKeyDown 事件發生之前呼叫。

(繼承來源 Control)
OnPreviewKeyUp(KeyRoutedEventArgs)

PreviewKeyUp 事件發生之前呼叫。

(繼承來源 Control)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)

在應用程式中處理 鍵盤快速鍵 (或快速鍵) 之前呼叫。 每當應用程式程式碼或內部進程呼叫 ProcessKeyboardAccelerators時叫用。 覆寫此方法以影響預設加速器處理。

(繼承來源 UIElement)
OnRightTapped(RightTappedRoutedEventArgs)

發生 RightTapped 事件之前呼叫。

(繼承來源 Control)
OnTapped(TappedRoutedEventArgs)

點選 事件發生之前呼叫。

(繼承來源 Control)
PopulatePropertyInfo(String, AnimationPropertyInfo)

定義可以產生動畫效果的屬性。

(繼承來源 UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)

在衍生類別中覆寫時,定義可以產生動畫效果的屬性。

(繼承來源 UIElement)
PrepareContainerForItemOverride(DependencyObject, Object)

準備指定項目 (Element) 以顯示指定項目 (Item)。

(繼承來源 ItemsControl)
ReadLocalValue(DependencyProperty)

如果已設定本機值,則會傳回相依性屬性的本機值。

(繼承來源 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)

註冊通知函式,以接聽此DependencyObject實例上特定DependencyProperty的變更。

(繼承來源 DependencyObject)
ReleasePointerCapture(Pointer)

釋放指標擷取,以供這個 UIElement擷取一個特定指標。

(繼承來源 UIElement)
ReleasePointerCaptures()

釋放這個專案保留的所有指標擷取。

(繼承來源 UIElement)
RemoveFocusEngagement()

從支援 Xbox 控制器互動的焦點條件約束中釋放控制項, (IsFocusEngaged 為 true) 。

(繼承來源 Control)
RemoveHandler(RoutedEvent, Object)

從這個 UIElement移除指定的路由事件處理常式。 通常會由 AddHandler新增有問題的處理常式。

(繼承來源 UIElement)
SetBinding(DependencyProperty, BindingBase)

使用提供的系結物件,將系結附加至 FrameworkElement

(繼承來源 FrameworkElement)
SetValue(DependencyProperty, Object)

DependencyObject上設定相依性屬性的本機值。

(繼承來源 DependencyObject)
StartAnimation(ICompositionAnimationBase)

開始專案上的指定動畫。

(繼承來源 UIElement)
StartBringIntoView()

起始 XAML 架構的要求,以將元素帶入其內含之任何可捲動區域內的檢視。

(繼承來源 UIElement)
StartBringIntoView(BringIntoViewOptions)

初始化 XAML 架構的要求,以使用指定的選項將專案帶入檢視。

(繼承來源 UIElement)
StartDragAsync(ExpPointerPoint)

代表文字控制項,當使用者使用鍵盤或手寫筆 (使用筆跡和手寫辨識) 輸入文字時,向使用者提出建議。 當使用者變更文字時,應用程式會收到通知,並負責提供要顯示此控制項的相關建議。

(繼承來源 UIElement)
StartDragAsync(PointerPoint)

啟始拖放作業。

重要

如果使用者以系統管理員身分以提升許可權模式執行應用程式,則不支援。

(繼承來源 UIElement)
StopAnimation(ICompositionAnimationBase)

停止元素上的指定動畫。

(繼承來源 UIElement)
TransformToVisual(UIElement)

傳回轉換物件,可用來將 UIElement 的座標轉換為指定的物件。

(繼承來源 UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)

嘗試搜尋 UIElement 的整個視覺化樹狀結構, 以叫用鍵盤快速鍵 (或快速鍵)

(繼承來源 UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)

取消先前透過呼叫 RegisterPropertyChangedCallback註冊的變更通知。

(繼承來源 DependencyObject)
UpdateLayout()

確保 UIElement 子物件的所有位置都已針對版面配置正確更新。

(繼承來源 UIElement)

事件

AccessKeyDisplayDismissed

發生于不應再顯示存取金鑰時。

(繼承來源 UIElement)
AccessKeyDisplayRequested

發生于使用者要求顯示存取金鑰時。

(繼承來源 UIElement)
AccessKeyInvoked

發生于使用者完成存取金鑰序列時。

(繼承來源 UIElement)
ActualThemeChanged

發生于 ActualTheme 屬性值已變更時。

(繼承來源 FrameworkElement)
BringIntoViewRequested

在這個專案或其中一個子代上呼叫 StartBringIntoView 時發生。

(繼承來源 UIElement)
CharacterReceived

發生于輸入佇列收到單一撰寫字元時。

(繼承來源 UIElement)
ContextCanceled

發生于內容輸入手勢繼續進入操作手勢時,通知專案不應開啟內容飛出視窗。

(繼承來源 UIElement)
ContextRequested

發生于使用者已完成內容輸入手勢時,例如按一下滑鼠右鍵。

(繼承來源 UIElement)
DataContextChanged

發生于 FrameworkElement.DataCoNtext 屬性的值變更時。

(繼承來源 FrameworkElement)
DoubleTapped

發生于在此元素的點擊測試區域上發生未處理的 DoubleTap 互動時。

(繼承來源 UIElement)
DragEnter

當輸入系統報告基礎拖曳事件,並將這個專案當做目標時發生。

(繼承來源 UIElement)
DragLeave

當輸入系統報告基礎拖曳事件,並將這個專案當做原點時發生。

(繼承來源 UIElement)
DragOver

在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。

(繼承來源 UIElement)
DragStarting

發生于起始拖曳作業時。

(繼承來源 UIElement)
Drop

輸入系統報告其下以這個項目作為置放目標的置放事件時發生。

(繼承來源 UIElement)
DropCompleted

發生于以這個專案做為結束來源的拖放作業時。

(繼承來源 UIElement)
EffectiveViewportChanged

發生于 FrameworkElement的有效檢視區 變更時。

(繼承來源 FrameworkElement)
FocusDisengaged

當使用者按下 Xbox 控制器上的 B/上一頁按鈕時,會從控制項放開焦點時發生。

(繼承來源 Control)
FocusEngaged

發生于使用者按下 Xbox 控制器上的 A/Select 按鈕時,焦點受限於控制項。

(繼承來源 Control)
GettingFocus

發生于 UIElement 收到焦點之前。 此事件會同步引發,以確保事件反升時不會移動焦點。

(繼承來源 UIElement)
GotFocus

發生于 UIElement 收到焦點時。 此事件會以非同步方式引發,因此焦點可以在反升完成之前再次移動。

(繼承來源 UIElement)
Holding

發生于在此元素的點擊測試區域上發生未處理的 保留 互動時。

(繼承來源 UIElement)
IsEnabledChanged

發生于 IsEnabled 屬性變更時。

(繼承來源 Control)
KeyDown

UIElement 有焦點時按下鍵盤按鍵時發生。

(繼承來源 UIElement)
KeyUp

發生于 UIElement 有焦點時放開鍵盤按鍵時。

(繼承來源 UIElement)
LayoutUpdated

發生于視覺化樹狀結構的版面配置變更時,因為配置相關屬性變更值或重新整理版面配置的其他動作。

(繼承來源 FrameworkElement)
Loaded

發生于 架構Element 已建構並新增至物件樹狀結構,並準備好進行互動時。

(繼承來源 FrameworkElement)
Loading

FrameworkElement 開始載入時發生。

(繼承來源 FrameworkElement)
LosingFocus

發生于 UIElement 失去焦點之前。 此事件會同步引發,以確保事件反升時不會移動焦點。

(繼承來源 UIElement)
LostFocus

發生于 UIElement 失去焦點時。 此事件會以非同步方式引發,因此焦點可以在反升完成之前再次移動。

(繼承來源 UIElement)
ManipulationCompleted

發生于 UIElement 上的操作完成時。

(繼承來源 UIElement)
ManipulationDelta

輸入裝置在操作期間變更位置時發生。

(繼承來源 UIElement)
ManipulationInertiaStarting

在操作和慣性開始的時候,只要輸入裝置不與 UIElement 物件接觸便發生。

(繼承來源 UIElement)
ManipulationStarted

當輸入裝置開始在 UIElement 進行操作時發生。

(繼承來源 UIElement)
ManipulationStarting

發生於第一次建立操作處理器時。

(繼承來源 UIElement)
NoFocusCandidateFound

發生于使用者嘗試透過定位鍵或方向箭號 (移動焦點時) ,但焦點不會移動,因為沒有在移動方向找到焦點候選項目。

(繼承來源 UIElement)
PointerCanceled

發生于讓連絡人異常遺失連絡人的指標時。

(繼承來源 UIElement)
PointerCaptureLost

發生于此元素先前保留的指標擷取移至另一個專案或其他地方時。

(繼承來源 UIElement)
PointerEntered

發生于指標進入這個專案的點擊測試區域時。

(繼承來源 UIElement)
PointerExited

發生于指標離開這個專案的點擊測試區域時。

(繼承來源 UIElement)
PointerMoved

當指標在指標保留在這個專案的點擊測試區域中時移動時發生。

(繼承來源 UIElement)
PointerPressed

發生于指標裝置起始這個專案內的 Press 動作時。

(繼承來源 UIElement)
PointerReleased

發生于先前起始 「按下」 動作的指標裝置釋放時,同時在此元素內。 請注意, Press 動作的結尾不保證會引發 PointerReleased 事件;其他事件可能會改為引發。 如需詳細資訊,請參閱。

(繼承來源 UIElement)
PointerWheelChanged

發生于指標滾輪的差異值變更時。

(繼承來源 UIElement)
PreviewKeyDown

發生于 UIElement 有焦點時按下鍵盤按鍵時。

(繼承來源 UIElement)
PreviewKeyUp

發生于 UIElement 有焦點時放開鍵盤按鍵時。

(繼承來源 UIElement)
ProcessKeyboardAccelerators

發生于按下 鍵盤快速鍵 (或快速鍵) 時。

(繼承來源 UIElement)
QuerySubmitted

發生于使用者提交搜尋查詢時。

RightTapped

發生于指標位於元素上方時發生右點選輸入壓力時。

(繼承來源 UIElement)
SizeChanged

發生于 ActualHeightActualWidth 屬性變更 FrameworkElement上的值時。

(繼承來源 FrameworkElement)
SuggestionChosen

在可編輯控制群組件的文字內容更新之前引發。

Tapped

發生于此元素的點擊測試區域上發生未處理的 Tap 互動時。

(繼承來源 UIElement)
TextChanged

在更新可編輯控制群組件的文字內容之後引發。

Unloaded

當這個物件不再連接到主物件樹狀結構時發生。

(繼承來源 FrameworkElement)

適用於

另請參閱