CalendarDatePicker 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示控件,允許使用者從行事曆顯示中挑選日期。
/// [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 CalendarDatePicker : Control
[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 class CalendarDatePicker : Control
Public Class CalendarDatePicker
Inherits Control
- 繼承
- 屬性
範例
提示
如需詳細資訊、設計指引和程式碼範例,請參閱 行事曆日期選擇器。
WinUI 3 資源庫應用程式包含大部分 WinUI 3 控制件、特性和功能的互動式範例。 從 Microsoft Store 取得應用程式,或在 GitHub 上取得原始程式碼
備註
CalendarDatePicker 是一種下拉式控制項,最適合用來從行事曆檢視中挑選單一日期,然後取得各種重要的相關資訊,例如星期幾或行事曆行程密度。 它類似於 DatePicker 控件,但 DatePicker 已針對挑選已知日期進行優化,例如生日,其中行事曆的內容並不重要。
您可以使用預設表單中的 CalendarDatePicker 控件,搭配最少數量的 Extensible Application Markup Language (XAML) 或其他程式代碼,或者您可以用各種方式自定義它以符合您的應用程式。 以下是以 Extensible Application Markup Language (XAML) 和程式代碼建立的簡單 CalendarDatePicker。
CalendarDatePicker arrivalCalendarDatePicker = new CalendarDatePicker();
<CalendarDatePicker x:Name="arrivalCalendarDatePicker"/>
以下是控件關閉且未選取日期時的外觀。
以下是行事曆開啟和選取日期的外觀。CalendarDatePicker 具有用於挑選日期的內部 CalendarView 。 CalendarView 屬性的子集,例如 IsTodayHighlighted 和 FirstDayOfWeek,存在於 CalendarDatePicker 上,並轉送至內部 CalendarView 以讓您加以修改。 不過,您無法變更內部 CalendarView 的 SelectionMode,以允許多重選取。 如果您需要讓用戶挑選多個日期,或需要一律顯示行事曆,請考慮使用 CalendarView 而不是 CalendarDatePicker。 如需如何修改行事曆顯示的詳細資訊,請參閱 CalendarView 類別。
選取日期
使用 Date 屬性來取得日期或設定選取的日期。 根據預設, Date 屬性為 null。 當使用者在行事曆檢視中選取一個日期時,便會更新這個屬性。 使用者可以按一下行事曆檢視中選取的日期,以取消選取該日期。
您可以在程式碼中按照以下方式設定日期。
myCalendarDatePicker.Date = new DateTime(1977, 1, 5);
當您在程式代碼中設定 Date 時,此值會受限於 MinDate 和 MaxDate 屬性。 如果 Date 小於 MinDate,值會設定為 MinDate。 如果 Date 大於 MaxDate,值會設定為 MaxDate。
您可以處理 DateChanged 事件,以在 Date 值變更時收到通知。
格式化選取的日期
您可以變更所選取日期的日期、月份和年份的顯示格式。 CalendarDatePicker 之 TextBox 部分的字串內容是由 DateTimeFormatter 所建立。 您可以提供格式範本或格式模式的字串,告訴 DateTimeFormatter 如何格式化值。 如需格式範本和格式模式的完整清單,請參閱 DateTimeFormatter 類別檔的一節。
以下是如何使用格式模式在 XAML 和程式碼中指定格式。
<CalendarDatePicker x:Name="myCalendarDatePicker"
DateFormat = "{}{dayofweek.full}, {month.full} {day.integer}, {year.full}"/>
myCalendarDatePicker.DateFormat = "{dayofweek.full}, {month.full} {day.integer}, {year.full}";
選取的日期看起來像這樣,且日期已格式化。
設定標頭與預留位置文字
您可以將 Header (或 label) 和 PlaceholderText (或 watermark) 新增至 CalendarDatePicker,讓使用者知道其用途。 若要自定義標頭的外觀,您可以設定 HeaderTemplate 屬性,而不是 Header。 如需設計資訊,請參閱 卷標的指導方針。
預設佔位元文字為「選取日期 」。 您可以將 PlaceholderText 屬性設定為空字串串,也可以提供自定義文字,如下所示。
<CalendarDatePicker x:Name="arrivalCalendarDatePicker" Header="Arrival date" PlaceholderText="Choose your arrival date"/>
全球化
CalendarDatePicker 支援 Windows 支援的每個行事曆系統。 這些行事曆是在 Windows.Globalization.CalendarIdentifiers 類別中指定。 CalendarDatePicker 會針對應用程式的默認語言使用正確的行事曆,或者您可以將 CalendarIdentifier 屬性設定為使用特定的行事歷系統。
DateTime 與 Calendar 值
CalendarDatePicker 中使用的日期對象會根據您的程式設計語言而有不同的表示法。 C# 和 Visual Basic 使用屬於 .NET 一部分的 System.DateTimeOffset 結構。 (C++/CX) Visual C++ 元件延伸模組會使用 Windows::Foundation::D ateTime 結構。 相關的概念是 Calendar 類別,會影響在內容中解譯日期的方式。 所有 Windows 執行階段應用程式都可以使用 Windows.Globalization.Calendar 類別。 C# 和 Visual Basic 應用程式也可以使用 System.Globalization.Calendar 類別,它包含非常類似的功能。 (Windows 執行階段 應用程式可以使用基底 .NET 行事歷類別,但不能使用特定的實作,例如 GregorianCalendar.)
.NET 亦支援名為 DateTime 的類型,隱含可轉換為 DateTimeOffset。 因此,您可能會在 .NET 程式代碼中看到用來設定真正 DateTimeOffset 值的 “DateTime” 類型。 如需 DateTime 與 DateTimeOffset 之間差異的詳細資訊,請參閱 DateTimeOffset 中的。
注意
接受日期對象的屬性無法設定為 XAML 屬性字串,因為 Windows 執行階段 XAML 剖析器沒有將字串轉換成日期的轉換邏輯做為DateTime DateTimeOffset/ 物件。 您通常會在程式碼中設定這些值。 另一個可能的技巧是定義可用為數據對象或數據內容中的日期,然後將屬性設定為 XAML 屬性,以參考 {Binding} 標記延伸 運算式,以存取日期做為數據。
控件樣式和範本
您可以修改預設 的 Style 和 ControlTemplate ,讓控件具有唯一的外觀。 如需修改控件樣式和範本的相關信息,請參閱 XAML 樣式。 定義控件外觀的預設樣式、範本和資源會包含在檔案中 generic.xaml
。 為了設計目的,generic.xaml
會與 Windows 應用程式 SDK NuGet 套件一起安裝。 根據預設,此位置為 \Users\<username>\.nuget\packages\microsoft.windowsappsdk\<version>\lib\uap10.0\Microsoft.UI\Themes\generic.xaml
。 不同 SDK 版本的樣式和資源可能會有不同的值。
XAML 也包含資源,可讓您用來修改不同視覺狀態中控件的色彩,而不需修改控件範本。 修改這些資源是慣用的設定屬性,例如 Background 和 Foreground。 如需詳細資訊,請參閱 XAML 樣式文章的輕量型樣式一節。
建構函式
CalendarDatePicker() |
初始化 CalendarDatePicker 類別的新實例。 |
屬性
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) |
Background |
取得或設定提供控件背景的筆刷。 (繼承來源 Control) |
BackgroundSizing |
取得或設定值,這個值表示背景相對於這個專案框線的延伸程度。 (繼承來源 Control) |
BaseUri |
取得統一資源識別元 (URI) ,代表 XAML 載入時間 XAML 建構物件的基底 URI。 此屬性適用於運行時間的 URI 解析。 (繼承來源 FrameworkElement) |
BorderBrush |
取得或設定描述控制件框線填滿的筆刷。 (繼承來源 Control) |
BorderThickness |
取得或設定控制項的框線粗細。 (繼承來源 Control) |
CacheMode |
取得或設定值,這個值表示盡可能將轉譯的內容快取為復合位圖。 (繼承來源 UIElement) |
CalendarIdentifier |
取得或設定要使用的行事曆系統。 |
CalendarIdentifierProperty |
識別 CalendarIdentifier 相依性屬性。 |
CalendarViewStyle |
取得或設定與控件內部 CalendarView 物件相關聯的 Style。 |
CalendarViewStyleProperty |
識別 CalendarViewStyle 相依性屬性。 |
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 的數據內容。 數據內容的常見用法是當 |
Date |
取得或設定目前在行事曆選擇器中設定的日期。 |
DateFormat |
取得或設定選擇器文字框中日期值的顯示格式。 |
DateFormatProperty |
識別 DateFormat 相依性屬性。 |
DateProperty |
識別 Date 相依性屬性。 |
DayOfWeekFormat |
取得或設定選擇器 CalendarView 中周首日的顯示格式。 |
DayOfWeekFormatProperty |
識別 DayOfWeekFormat 相依性屬性。 |
DefaultStyleKey |
取得或設定參考控件預設樣式的索引鍵。 自定義控件的作者會使用此屬性來變更其控件所使用的樣式預設值。 (繼承來源 Control) |
DefaultStyleResourceUri |
取得或設定資源文件的路徑,其中包含控件的默認樣式。 (繼承來源 Control) |
Description |
取得或設定控制件下方顯示的內容。 內容應該提供控件預期之輸入的指引。 |
DescriptionProperty |
識別 Description 相依性屬性。 |
DesiredSize |
取得此 UIElement 在版面配置程式的量值階段期間計算的大小。 (繼承來源 UIElement) |
Dispatcher |
一律會在 |
DispatcherQueue |
|
DisplayMode |
取得或設定值,這個值表示行事曆是否會在選擇器的 CalendarView 中顯示月份、年份或十年的選取專案。 |
DisplayModeProperty |
識別 DisplayMode 相依性屬性。 |
ElementSoundMode |
取得或設定值,指定是否播放音效的控件喜好設定。 (繼承來源 Control) |
ExitDisplayModeOnAccessKeyInvoked |
取得或設定值,這個值會指定叫用存取金鑰時,是否關閉存取密鑰顯示。 (繼承來源 UIElement) |
FirstDayOfWeek |
取得或設定值,這個值表示選擇器 CalendarView 中當周的第一天顯示哪一天。 |
FirstDayOfWeekProperty |
識別 FirstDayOfWeek 相依性屬性。 |
FlowDirection |
取得或設定文字和其他UI元素在控制其版面配置的任何父元素內流動的方向。 這個屬性可以設定為 |
FocusState |
取得值,這個值會指定這個控件是否有焦點,以及取得焦點的模式。 (繼承來源 UIElement) |
FocusVisualMargin |
取得或設定 FrameworkElement 焦點視覺效果的外部邊界。 (繼承來源 FrameworkElement) |
FocusVisualPrimaryBrush |
取得或設定筆刷,用來繪製 FrameworkElement 之或 |
FocusVisualPrimaryThickness |
取得或設定 FrameworkElement 之外部 |
FocusVisualSecondaryBrush |
取得或設定筆刷,用來繪製 FrameworkElement 之或 |
FocusVisualSecondaryThickness |
取得或設定 FrameworkElement 之 |
FontFamily |
取得或設定顯示控制項的文字所用的字型。 (繼承來源 Control) |
FontSize |
取得或設定這個控制件中的文字大小。 (繼承來源 Control) |
FontStretch |
取得或設定螢幕上字型緊縮或加寬的程度。 (繼承來源 Control) |
FontStyle |
取得或設定轉譯文字的樣式。 (繼承來源 Control) |
FontWeight |
取得或設定指定字型的粗細。 (繼承來源 Control) |
Foreground |
取得或設定描述前景色彩的筆刷。 (繼承來源 Control) |
Header |
取得或設定行事曆選擇器標頭的內容。 |
HeaderProperty |
識別 標頭 相依性屬性。 |
HeaderTemplate |
取得或設定用來顯示標頭內容的 DataTemplate 。 |
HeaderTemplateProperty |
識別 HeaderTemplate 相依性屬性。 |
Height |
取得或設定 FrameworkElement 的建議高度。 (繼承來源 FrameworkElement) |
HighContrastAdjustment |
取得或設定值,這個值表示當啟用高對比度主題時,架構是否會自動調整專案的視覺屬性。 (繼承來源 UIElement) |
HorizontalAlignment |
取得或設定在版面配置父系中撰寫時套用至 FrameworkElement 的水準對齊特性,例如面板或專案控件。 (繼承來源 FrameworkElement) |
HorizontalContentAlignment |
取得或設定控制項內容的水平對齊。 (繼承來源 Control) |
IsAccessKeyScope |
取得或設定值,這個值表示專案是否定義自己的訪問鍵範圍。 (繼承來源 UIElement) |
IsCalendarOpen |
取得或設定值,這個值表示目前是否顯示 CalendarDatePicker 的行事歷檢視。 |
IsCalendarOpenProperty |
識別 IsCalendarOpen 相依性屬性。 |
IsDoubleTapEnabled |
取得或設定值,這個值會判斷 DoubleTapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
IsEnabled |
取得或設定值,指出使用者是否可以與控件互動。 (繼承來源 Control) |
IsFocusEngaged |
取得或設定值,指出當使用者按下遊戲控制器上的 A/Select 按鈕時,焦點是否受限於控件。 (繼承來源 Control) |
IsFocusEngagementEnabled |
取得或設定值,指出當使用者按下遊戲控制器上的 A/Select 按鈕時,焦點是否可以限制為控件。 (繼承來源 Control) |
IsGroupLabelVisible |
取得或設定值,這個值表示月份名稱是否以選擇器 CalendarView 中月份的第一天顯示。 |
IsGroupLabelVisibleProperty |
識別 IsGroupLabelVisible 相依性屬性。 |
IsHitTestVisible |
取得或設定這個 UIElement 的包含區域是否可以傳回 true 值來進行點擊測試。 (繼承來源 UIElement) |
IsHoldingEnabled |
取得或設定值,這個值會判斷 Holding 事件是否可以來自該專案。 (繼承來源 UIElement) |
IsLoaded |
取得值,這個值表示專案是否已加入至專案樹狀結構,且已準備好進行互動。 (繼承來源 FrameworkElement) |
IsOutOfScopeEnabled |
取得或設定值,這個值表示選擇器 CalendarView 中是否以唯一的前景色彩顯示範圍外 行事歷專案。 |
IsOutOfScopeEnabledProperty |
識別 IsOutOfScopeEnabled 相依性屬性。 |
IsRightTapEnabled |
取得或設定值,這個值會判斷 RightTapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
IsTabStop |
取得或設定值,這個值表示控制項是否包含於索引標籤巡覽。 (繼承來源 UIElement) |
IsTapEnabled |
取得或設定值,這個值會判斷 Tapped 事件是否可能來自該專案。 (繼承來源 UIElement) |
IsTextScaleFactorEnabled |
取得或設定是否啟用自動放大文字,以反映系統文字大小設定。 (繼承來源 Control) |
IsTodayHighlighted |
取得或設定值,這個值表示選擇器的 CalendarView 中是否反白顯示目前日期。 |
IsTodayHighlightedProperty |
識別 IsTodayHighlighted 相依性屬性。 |
KeyboardAcceleratorPlacementMode |
取得或設定值,這個值表示控件 工具提示 是否顯示其相關聯鍵盤快捷方式的按鍵組合。 (繼承來源 UIElement) |
KeyboardAcceleratorPlacementTarget |
取得或設定值,這個值表示顯示快速鍵組合的控件 工具提示 。 (繼承來源 UIElement) |
KeyboardAccelerators |
取得使用鍵盤叫用動作的按鍵組合集合。 快捷鍵通常會指派給按鈕或功能表項。
|
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) |
MaxDate |
取得或設定可在選擇器中設定的最新日期。 |
MaxDateProperty |
識別 MaxDate 相依性屬性。 |
MaxHeight |
取得或設定 FrameworkElement 的最大高度條件約束。 (繼承來源 FrameworkElement) |
MaxWidth |
取得或設定 FrameworkElement 的最大寬度條件約束。 (繼承來源 FrameworkElement) |
MinDate |
取得或設定可在選擇器中設定的最早日期。 |
MinDateProperty |
識別 MinDate 相依性屬性。 |
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) |
RasterizationScale |
取得值,表示每個檢視圖元的原始 (實體) 像素數目。 (繼承來源 UIElement) |
RenderSize |
取得 UIElement的最終轉譯大小。 不建議使用,請參閱。 (繼承來源 UIElement) |
RenderTransform |
取得或設定會影響 UIElement轉譯位置的轉換資訊。 (繼承來源 UIElement) |
RenderTransformOrigin |
取得或設定 RenderTransform 所宣告之任何可能轉譯轉換的原點,相對於 UIElement 的界限。 (繼承來源 UIElement) |
RequestedTheme |
取得或設定 UIElement (及其子元素) 用於資源判斷的 UI 主題。 您指定的 |
RequiresPointer |
取得或設定UI元素是否支援滑鼠模式,以模擬非指標輸入裝置的指標互動體驗,例如鍵盤或遊戲控制器。 (繼承來源 Control) |
Resources |
取得本機定義的資源字典。 在 XAML 中,您可以透過 XAML 隱含集合語法,將資源專案建立為屬性專案的子物件專案 |
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 的索引卷標序列中包含物件。 |
Tag |
取得或設定任意物件值,可用來儲存這個物件的自定義資訊。 (繼承來源 FrameworkElement) |
Template |
取得或設定控制項範本。 控件範本會定義 UI 中控制件的視覺外觀,並在 XAML 標記中定義。 (繼承來源 Control) |
Transform3D |
取得或設定轉譯這個專案時要套用的 3D 轉換效果。 (繼承來源 UIElement) |
TransformMatrix |
取得或設定要套用至項目的轉換矩陣。 (繼承來源 UIElement) |
Transitions |
取得或設定套用至 UIElement 的 Transition 樣式專案集合。 (繼承來源 UIElement) |
Translation |
取得或設定專案的 x、y 和 z 轉譯位置。 (繼承來源 UIElement) |
TranslationTransition |
取得或設定 Vector3Transition,以動畫顯示 Translation 屬性的變更。 (繼承來源 UIElement) |
Triggers |
取得針對 FrameworkElement 定義的動畫觸發程式集合。 不常使用。 請參閱<備註>。 (繼承來源 FrameworkElement) |
UseLayoutRounding |
取得或設定值,這個值會判斷物件及其視覺子樹的轉譯是否應該使用四捨五入行為,將轉譯對齊整個圖元。 (繼承來源 UIElement) |
UseSystemFocusVisuals |
取得或設定值,這個值表示控件是否使用由控件範本中定義的系統或焦點視覺效果所繪製的焦點視覺效果。 (繼承來源 UIElement) |
VerticalAlignment |
取得或設定在面板或專案控件等父物件中撰寫時套用至 FrameworkElement 的垂直對齊特性。 (繼承來源 FrameworkElement) |
VerticalContentAlignment |
取得或設定控制項內容的垂直對齊。 (繼承來源 Control) |
Visibility |
取得或設定 UIElement的可見性。
|
Width |
取得或設定 FrameworkElement 的寬度。 (繼承來源 FrameworkElement) |
XamlRoot |
取得或設定 |
XYFocusDown |
取得或設定對象,當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點。 (繼承來源 UIElement) |
XYFocusDownNavigationStrategy |
取得或設定值,指定用來判斷向下瀏覽之目標元素的策略。 (繼承來源 UIElement) |
XYFocusKeyboardNavigation |
取得或設定值,這個值會啟用或停用使用鍵盤方向箭號的流覽。 (繼承來源 UIElement) |
XYFocusLeft |
取得或設定物件,當用戶在遊戲控制器的 Directional Pad (D 鍵) 左鍵時取得焦點。 (繼承來源 UIElement) |
XYFocusLeftNavigationStrategy |
取得或設定值,指定用來判斷左側導覽之目標元素的策略。 (繼承來源 UIElement) |
XYFocusRight |
取得或設定對象,當用戶在遊戲控制器的 Directional Pad (D-pad) 上按下滑鼠右鍵時,取得焦點。 (繼承來源 UIElement) |
XYFocusRightNavigationStrategy |
取得或設定值,指定用來判斷右導覽之目標元素的策略。 (繼承來源 UIElement) |
XYFocusUp |
取得或設定對象,當使用者按下遊戲控制器的 Directional Pad (D-pad) 時取得焦點。 (繼承來源 UIElement) |
XYFocusUpNavigationStrategy |
取得或設定值,指定用來判斷向上瀏覽之目標元素的策略。 (繼承來源 UIElement) |
方法
事件
AccessKeyDisplayDismissed |
發生於不應再顯示存取金鑰時。 (繼承來源 UIElement) |
AccessKeyDisplayRequested |
發生於使用者要求顯示存取金鑰時。 (繼承來源 UIElement) |
AccessKeyInvoked |
發生於使用者完成存取金鑰序列時。 (繼承來源 UIElement) |
ActualThemeChanged |
發生於 ActualTheme 屬性值已變更時。 (繼承來源 FrameworkElement) |
BringIntoViewRequested |
在這個專案或其其中一個子系上呼叫 StartBringIntoView 時發生。 (繼承來源 UIElement) |
CalendarViewDayItemChanging |
在選擇器的 CalendarView 中載入 CalendarViewDayItem 時發生。 |
CharacterReceived |
發生於輸入佇列收到單一撰寫字元時。 (繼承來源 UIElement) |
Closed |
會在選擇器的 CalendarView 隱藏時發生。 |
ContextCanceled |
當內容輸入手勢繼續進入操作手勢時發生,以通知專案不應開啟內容飛出視窗。 (繼承來源 UIElement) |
ContextRequested |
發生於使用者完成內容輸入手勢時,例如按滑鼠右鍵。 (繼承來源 UIElement) |
DataContextChanged |
發生於 FrameworkElement.DataContext 屬性的值變更時。 (繼承來源 FrameworkElement) |
DateChanged |
發生於日期值變更時。 |
DoubleTapped |
發生於此元素的點擊測試區域上發生未處理的 DoubleTap 互動時。 (繼承來源 UIElement) |
DragEnter |
當輸入系統報告具有這個專案作為目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
DragLeave |
當輸入系統報告基礎拖曳事件,並將這個項目當做原點時發生。 (繼承來源 UIElement) |
DragOver |
在輸入系統回報以此項目作為可能置放目標的基礎拖曳事件時發生。 (繼承來源 UIElement) |
DragStarting |
發生於起始拖曳作業時。 (繼承來源 UIElement) |
Drop |
輸入系統報告其下以這個項目作為置放目標的置放事件時發生。 (繼承來源 UIElement) |
DropCompleted |
發生於以這個專案做為來源結束的拖放作業時。 (繼承來源 UIElement) |
EffectiveViewportChanged |
發生於 FrameworkElement的有效檢視區 變更時。 (繼承來源 FrameworkElement) |
FocusDisengaged |
當使用者按下遊戲控制器上的 B/上一頁按鈕時,會從控件放開焦點時發生。 (繼承來源 Control) |
FocusEngaged |
發生於使用者按下遊戲控制器上的 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) |
Opened |
發生於顯示選擇器的 CalendarView 時。 |
PointerCanceled |
發生於讓聯繫人異常遺失聯繫人的指標時。 (繼承來源 UIElement) |
PointerCaptureLost |
發生於此元素先前保留的指標擷取移至另一個專案或其他地方時。 (繼承來源 UIElement) |
PointerEntered |
發生於指標進入這個項目的點擊測試區域時。 (繼承來源 UIElement) |
PointerExited |
發生於指標離開這個項目的點擊測試區域時。 (繼承來源 UIElement) |
PointerMoved |
當指標在指標保留在這個項目的點擊測試區域中時移動時發生。 (繼承來源 UIElement) |
PointerPressed |
發生於指標裝置起始這個專案內的 Press 動作時。 (繼承來源 UIElement) |
PointerReleased |
發生於先前起始 「按下」 動作的指標裝置釋放時,同時在此元素內。 請注意, Press 動作的結尾不保證會引發 |
PointerWheelChanged |
發生於指標滾輪的差異值變更時。 (繼承來源 UIElement) |
PreviewKeyDown |
發生於 UIElement 有焦點時按下鍵盤按鍵時。 (繼承來源 UIElement) |
PreviewKeyUp |
發生於 UIElement 有焦點時放開鍵盤按鍵時。 (繼承來源 UIElement) |
ProcessKeyboardAccelerators |
發生於按下 鍵盤快捷方式 (或快捷鍵) 時。 (繼承來源 UIElement) |
RightTapped |
發生於指標位於元素上方時發生右點選輸入壓力時。 (繼承來源 UIElement) |
SizeChanged |
發生於 ActualHeight 或 ActualWidth 屬性變更 FrameworkElement 上的值時。 (繼承來源 FrameworkElement) |
Tapped |
發生於此元素的點擊測試區域上發生未處理的 Tap 互動時。 (繼承來源 UIElement) |
Unloaded |
當這個物件不再連接到主物件樹狀結構時發生。 (繼承來源 FrameworkElement) |