DatePicker 類別

定義

允許選擇日期的 View

[Xamarin.Forms.RenderWith(typeof(Xamarin.Forms.Platform._DatePickerRenderer))]
public class DatePicker : Xamarin.Forms.View, Xamarin.Forms.IElementConfiguration<Xamarin.Forms.DatePicker>, Xamarin.Forms.Internals.IFontElement
type DatePicker = class
    inherit View
    interface IFontElement
    interface IElementConfiguration<DatePicker>
繼承
屬性
實作

備註

DatePicker 的視覺標記法與 其中 Entry 之一非常類似,不同之處在于挑選日期的特殊控制項會出現在鍵盤上。

下列範例會 DatePicker 建立顯示目前日期的工作,並允許使用者選取指定範圍之間的日期。 屬性的值 Date 是使用 x:Static 標記延伸來指定,而 MinimumDate 和 屬性則是使用 和 MaximumDate 標記呼叫 Parse 方法 x:FactoryMethod 來指定。

<StackLayout>
<DatePicker VerticalOptions="CenterAndExpand" Date="{x:Static sys:DateTime.Now}">
<DatePicker.Format>yyyy-MM-dd</DatePicker.Format>
<DatePicker.MinimumDate>
<sys:DateTime x:FactoryMethod="Parse">
<x:Arguments>
<x:String>Jan 1 2000</x:String>
</x:Arguments>
</sys:DateTime>
</DatePicker.MinimumDate>
<DatePicker.MaximumDate>
<sys:DateTime x:FactoryMethod="Parse">
<x:Arguments>
<x:String>Dec 31 2050</x:String>
</x:Arguments>
</sys:DateTime>
</DatePicker.MaximumDate>
</DatePicker>
</StackLayout>

建構函式

DatePicker()

初始化 DatePicker 類別的新執行個體。

欄位

CharacterSpacingProperty

允許選擇日期的 View

DateProperty

Date 可繫結屬性的備份存放區。

FontAttributesProperty

FontAttributes 屬性的備份存放區。

FontFamilyProperty

FontFamily 屬性的備份存放區。

FontSizeProperty

FontSize 屬性的備份存放區。

FormatProperty

Format 相依性屬性的備份存放區。

MaximumDateProperty

MaximumDate 可繫結屬性的備份存放區。

MinimumDateProperty

MinimumDate 可繫結屬性的備份存放區。

TextColorProperty

TextColor 屬性的備份存放區。

TextTransformProperty

允許選擇日期的 View

屬性

AnchorX

取得或設定任何轉換內中心點的 X 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AnchorY

取得或設定任何轉換內中心點的 Y 元件 (相對於項目界限)。 這是可繫結屬性。

(繼承來源 VisualElement)
AutomationId

取得或設定值,允許自動化架構尋找此項目並與之互動。

(繼承來源 Element)
Background

允許選擇日期的 View

(繼承來源 VisualElement)
BackgroundColor

取得或設定將會填滿 VisualElement 背景的色彩。 這是可繫結屬性。

(繼承來源 VisualElement)
Batched

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Behaviors

取得與此元素關聯的行為清單。 這是可繫結屬性。

(繼承來源 VisualElement)
BindingContext

取得或設定物件,這個物件包含屬於此 BindableObject 屬性繫結屬性將設為目標的屬性。

(繼承來源 BindableObject)
Bounds

取得項目的界限。

(繼承來源 VisualElement)
CharacterSpacing

允許選擇日期的 View

class

允許選擇日期的 View

(繼承來源 NavigableElement)
ClassId

取得或設定值,用來識別語意類似項目的集合。

(繼承來源 Element)
Clip

允許選擇日期的 View

(繼承來源 VisualElement)
Date

取得或設定顯示的日期。 這是可繫結屬性。

DisableLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Dispatcher

允許選擇日期的 View

(繼承來源 BindableObject)
EffectControlProvider

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Effects

套用至此項目的效果清單。

(繼承來源 Element)
FlowDirection

取得或設定配置流程方向。

(繼承來源 VisualElement)
FontAttributes

取得值,指出日期選擇器文字的字型為粗體、斜體,或兩者皆非。

FontFamily

取得或設定選擇器文字的字型家族。

FontSize

取得或設定選擇器中文字的字型大小。

Format

向使用者顯示的日期格式。 這是相依性屬性。

GestureController

取得檢視的軌跡控制器。

(繼承來源 View)
GestureRecognizers

與此檢視建立關聯的筆勢辨識器集合。

(繼承來源 View)
Height

取得此項目的目前呈現高度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
HeightRequest

取得或設定此項目所需的高度覆寫項。

(繼承來源 VisualElement)
HorizontalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
Id

取得值,可用來在應用程式執行期間唯一識別項目。

(繼承來源 Element)
InputTransparent

取得或設定值,這個值指出是否應該在使用者互動週期中包含此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsEnabled

取得或設定值,這個值指出使用者介面中是否已啟用此項目。 這是可繫結屬性。

(繼承來源 VisualElement)
IsFocused

取得值,這個值指出此項目目前是否為焦點。 這是可繫結屬性。

(繼承來源 VisualElement)
IsInNativeLayout

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsNativeStateConsistent

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsPlatformEnabled

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsTabStop

取得或設定值,這個值表示此元素是否包含於索引標籤巡覽。 這是可繫結屬性。

(繼承來源 VisualElement)
IsVisible

取得或設定值,這個值會決定此項目是否應成為視覺化樹狀結構的一部分。 這是可繫結屬性。

(繼承來源 VisualElement)
LogicalChildren

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Margin

取得或設定檢視的邊界。

(繼承來源 View)
MaximumDate

針對這個 DatePicker 可選取的最高日期。 這是可繫結屬性。

MinimumDate

針對這個 DatePicker 可選取的最低日期。 這是可繫結屬性。

MinimumHeightRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小高度。

(繼承來源 VisualElement)
MinimumWidthRequest

取得或設定值,這個值會覆寫項目在配置期間要求的最小寬度。

(繼承來源 VisualElement)
Navigation

允許選擇日期的 View

(繼承來源 NavigableElement)
NavigationProxy

允許選擇日期的 View

(繼承來源 NavigableElement)
Opacity

取得或設定套用至項目 (呈現時) 的不透明度值。 這是可繫結屬性。

(繼承來源 VisualElement)
Parent

取得或設定項目的父項目。

(繼承來源 Element)
ParentView
已過時。

取得即此項目最接近上階的項目,而此項目是 VisualElement

(繼承來源 Element)
Platform
已過時。

允許選擇日期的 View

(繼承來源 Element)
RealParent

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
Resources

取得或設定本機資源字典。

(繼承來源 VisualElement)
Rotation

取得或設定呈現元素時繞著 Z 軸 (仿射旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationX

取得或設定呈現元素時繞著 X 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
RotationY

取得或設定呈現元素時繞著 Y 軸 (透視旋轉) 的旋轉 (度)。

(繼承來源 VisualElement)
Scale

取得或設定套用至項目的縮放比例。

(繼承來源 VisualElement)
ScaleX

取得或設定要套用至 X 方向的小數位數值。

(繼承來源 VisualElement)
ScaleY

取得或設定要套用至 Y 方向的小數位數值。

(繼承來源 VisualElement)
Style

允許選擇日期的 View

(繼承來源 NavigableElement)
StyleClass

允許選擇日期的 View

(繼承來源 NavigableElement)
StyleId

取得或設定使用者定義值來唯一識別項目。

(繼承來源 Element)
TabIndex

允許選擇日期的 View

(繼承來源 VisualElement)
TextColor

取得或設定日期選擇器的文字色彩。

TextTransform

允許選擇日期的 View

TranslationX

取得或設定項目的 X 轉譯差異。

(繼承來源 VisualElement)
TranslationY

取得或設定項目的 Y 轉譯差異。

(繼承來源 VisualElement)
Triggers

取得與此項目建立關聯的觸發程序清單。 這是可繫結屬性。

(繼承來源 VisualElement)
VerticalOptions

取得或設定 LayoutOptions,定義如何在配置循環配置項目。 這是可繫結屬性。

(繼承來源 View)
Visual

允許選擇日期的 View

(繼承來源 VisualElement)
Width

取得此項目的目前呈現寬度。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
WidthRequest

取得或設定此項目所需的寬度覆寫項。

(繼承來源 VisualElement)
X

取得此項目的目前 X 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)
Y

取得此項目的目前 Y 位置。 這是唯讀的可繫結屬性。

(繼承來源 VisualElement)

方法

ApplyBindings()

將繫結套用至 BindingContext

(繼承來源 BindableObject)
BatchBegin()

表示項目屬性變更批次的開始。

(繼承來源 VisualElement)
BatchCommit()

表示項目命令批次的結束,而且現在應該已認可這些命令。

(繼承來源 VisualElement)
ChangeVisualState()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
ClearValue(BindableProperty)

清除 SetValue 針對 property 所設定的任何值。

(繼承來源 BindableObject)
ClearValue(BindablePropertyKey)

清除 SetValue 針對 propertyKey 所識別屬性設定的任何值。

(繼承來源 BindableObject)
CoerceValue(BindableProperty)

允許選擇日期的 View

(繼承來源 BindableObject)
CoerceValue(BindablePropertyKey)

允許選擇日期的 View

(繼承來源 BindableObject)
Descendants()

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
EffectIsAttached(String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
FindByName(String)

傳回具有指定名稱的元素。

(繼承來源 Element)
Focus()

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

(繼承來源 VisualElement)
GetChildElements(Point)

傳回顯示在所指定 point 下的子元素。

(繼承來源 View)
GetSizeRequest(Double, Double)
已過時。

傳回項目的 SizeRequest。 呼叫此方法會開始配置週期的測量傳遞。

(繼承來源 VisualElement)
GetValue(BindableProperty)

傳回 BindableProperty 中包含的值。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
GetValues(BindableProperty, BindableProperty, BindableProperty)
已過時。

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
InvalidateMeasure()

用來呼叫而使此 VisualElement 配置失效的方法。 引發 MeasureInvalidated 事件。

(繼承來源 VisualElement)
InvalidateMeasureNonVirtual(InvalidationTrigger)

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
IsSet(BindableProperty)

如果目標屬性存在且已設定,則傳回 true

(繼承來源 BindableObject)
Layout(Rectangle)

在配置週期期間更新項目的界限。

(繼承來源 VisualElement)
Measure(Double, Double, MeasureFlags)

傳回視覺項目為了在裝置上顯示時所需的最小大小。

(繼承來源 VisualElement)
NativeSizeChanged()

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
On<T>()

傳回此 DatePicker 的平台特定執行個體,可在其上呼叫平台特定方法。

OnBindingContextChanged()

只要 View 的繫結內容變更時就叫用。 覆寫這個方法可以為這個事件加入類別處理。

(繼承來源 View)
OnChildAdded(Element)

應用程式開發人員可以覆寫此方法,以便在新增子系時加以回應。

(繼承來源 VisualElement)
OnChildRemoved(Element)
已過時。

應用程式開發人員可以覆寫此方法,以便在移除子系時加以回應。

(繼承來源 VisualElement)
OnChildRemoved(Element, Int32)

允許選擇日期的 View

(繼承來源 VisualElement)
OnChildrenReordered()

每當即將發出 ChildrenReordered 事件時叫用。 實作這個方法可為此事件加入類別處理。

(繼承來源 VisualElement)
OnMeasure(Double, Double)

配置度量發生時所呼叫的方法。

(繼承來源 VisualElement)
OnParentSet()

允許選擇日期的 View

(繼承來源 NavigableElement)
OnPropertyChanged(String)

繫結屬性變更時呼叫的方法。

(繼承來源 Element)
OnPropertyChanging(String)

從子類別呼叫這個方法,以通知屬性即將發生變更。

(繼承來源 BindableObject)
OnSizeAllocated(Double, Double)

在配置週期期間設定項目的大小時,會呼叫此方法。 在發出 SizeChanged 事件之前會直接呼叫此方法。 實作這個方法可為此事件加入類別處理。

(繼承來源 VisualElement)
OnSizeRequest(Double, Double)
已過時。

這個方法會在配置週期的測量傳遞期間呼叫,以取得項目的所需大小。

(繼承來源 VisualElement)
OnTabIndexPropertyChanged(Int32, Int32)

允許選擇日期的 View

(繼承來源 VisualElement)
OnTabStopPropertyChanged(Boolean, Boolean)

允許選擇日期的 View

(繼承來源 VisualElement)
RemoveBinding(BindableProperty)

移除先前設定的繫結。

(繼承來源 BindableObject)
RemoveDynamicResource(BindableProperty)

移除先前設定的動態資源

(繼承來源 Element)
SetBinding(BindableProperty, BindingBase)

將繫結指派給屬性。

(繼承來源 BindableObject)
SetDynamicResource(BindableProperty, String)

透過具有所提供索引鍵的 DynamicResource,設定更新此項目的 BindableProperty 屬性。

(繼承來源 Element)
SetValue(BindableProperty, Object)

設定指定之屬性的值。

(繼承來源 BindableObject)
SetValue(BindablePropertyKey, Object)

設定 propertyKey 的值。

(繼承來源 BindableObject)
SetValueCore(BindableProperty, Object, SetValueFlags)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
SetValueFromRenderer(BindablePropertyKey, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
SizeAllocated(Double, Double)

在配置週期期間呼叫 SizeAllocated 來表示子樹狀結構配置的開頭。

(繼承來源 VisualElement)
TabIndexDefaultValueCreator()

允許選擇日期的 View

(繼承來源 VisualElement)
TabStopDefaultValueCreator()

允許選擇日期的 View

(繼承來源 VisualElement)
UnapplyBindings()

取消套用所有先前設定的繫結。

(繼承來源 BindableObject)
Unfocus()

取消將焦點設定至此項目。

(繼承來源 VisualElement)
UpdateFormsText(String, TextTransform)

允許選擇日期的 View

事件

BatchCommitted

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
BindingContextChanged

每當 BindingContext 屬性變更時引發。

(繼承來源 BindableObject)
ChildAdded

只要將子項目新增至項目時就發生。

(繼承來源 Element)
ChildRemoved

只要從項目移除子項目時就發生。

(繼承來源 Element)
ChildrenReordered

在 VisualElement 的子系已重新排序時發生。

(繼承來源 VisualElement)
DateSelected

Date 屬性變更時所引發的事件。

DescendantAdded

只要將子項目新增至項目樹狀子目錄時即發生。

(繼承來源 Element)
DescendantRemoved

只要從項目樹狀子目錄移除子項目時即發生。

(繼承來源 Element)
FocusChangeRequested

供 Xamarin.Forms 平台內部使用。

(繼承來源 VisualElement)
Focused

在項目取得焦點時發生。

(繼承來源 VisualElement)
MeasureInvalidated

視覺項目配置失效時所引發的事件。

(繼承來源 VisualElement)
PlatformSet
已過時。

允許選擇日期的 View

(繼承來源 Element)
PropertyChanged

在屬性變更時引發。

(繼承來源 BindableObject)
PropertyChanging

在屬性即將變更時引發。

(繼承來源 BindableObject)
SizeChanged

當這個項目的 Width 或 Height 屬性變更值時發生。

(繼承來源 VisualElement)
Unfocused

在項目失去焦點時發生。

(繼承來源 VisualElement)

明確介面實作

IDynamicResourceHandler.SetDynamicResource(BindableProperty, String)

供 Xamarin.Forms 平台內部使用。

(繼承來源 BindableObject)
IElementController.SetValueFromRenderer(BindableProperty, Object)

供 Xamarin.Forms 平台內部使用。

(繼承來源 Element)
IFontElement.FontSizeDefaultValueCreator()

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontAttributesChanged(FontAttributes, FontAttributes)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontChanged(Font, Font)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontFamilyChanged(String, String)

供 Xamarin.Forms 平台內部使用。

IFontElement.OnFontSizeChanged(Double, Double)

供 Xamarin.Forms 平台內部使用。

IGestureController.CompositeGestureRecognizers

供 Xamarin.Forms 平台內部使用。

(繼承來源 View)
INameScope.RegisterName(String, Object)

僅供內部使用。

(繼承來源 Element)
IVisualElementController.EffectiveFlowDirection

取得平台上項目的有效視覺流程方向,並將地區設定和邏輯流程設定納入考量。

(繼承來源 VisualElement)
IVisualElementController.InvalidateMeasure(InvalidationTrigger)

此方法供內部使用。

(繼承來源 VisualElement)

擴充方法

AbortAnimation(IAnimatable, String)

停止動畫。

Animate(IAnimatable, String, Action<Double>, Double, Double, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Action<Double>, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate(IAnimatable, String, Animation, UInt32, UInt32, Easing, Action<Double,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

Animate<T>(IAnimatable, String, Func<Double,T>, Action<T>, UInt32, UInt32, Easing, Action<T,Boolean>, Func<Boolean>)

設定指定參數並開始動畫。

AnimateKinetic(IAnimatable, String, Func<Double,Double,Boolean>, Double, Double, Action)

設定指定參數並開始動態動畫。

AnimationIsRunning(IAnimatable, String)

傳回布林值,指出由 handle 指定的動畫是否正在執行中。

Batch(IAnimatable)

允許選擇日期的 View

GetPropertyIfSet<T>(BindableObject, BindableProperty, T)

允許選擇日期的 View

SetAppThemeColor(BindableObject, BindableProperty, Color, Color)

允許選擇日期的 View

SetBinding(BindableObject, BindableProperty, String, BindingMode, IValueConverter, String)

建立並將繫結套用至屬性。

SetBinding<TSource>(BindableObject, BindableProperty, Expression<Func<TSource,Object>>, BindingMode, IValueConverter, String)
已過時。

從運算式建立及套用繫結。

SetOnAppTheme<T>(BindableObject, BindableProperty, T, T)

允許選擇日期的 View

FindByName<T>(Element, String)

傳回包含 element 的範圍中具有 name 名稱的 T 類型執行個體。

FindNextElement(ITabStopElement, Boolean, IDictionary<Int32,List<ITabStopElement>>, Int32)

允許選擇日期的 View

GetSortedTabIndexesOnParentPage(VisualElement)

允許選擇日期的 View

GetTabIndexesOnParentPage(ITabStopElement, Int32)

允許選擇日期的 View

FadeTo(VisualElement, Double, UInt32, Easing)

傳回僅根據 opacitylengtheasing 參數描述的內容執行淡化的工作。

LayoutTo(VisualElement, Rectangle, UInt32, Easing)

傳回一個工作,其可將 view 所指定 VisualElement 的邊界,緩移為 bounds 參數所指定的矩形。

RelRotateTo(VisualElement, Double, UInt32, Easing)

view 所指定的 VisualElement,從其目前的旋轉,加以旋轉 drotation

RelScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 從其目前大小縮放至 dscale 的工作。

RotateTo(VisualElement, Double, UInt32, Easing)

傳回執行由 rotationlengtheasing 參數所描述旋轉的工作。

RotateXTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity,耗費時間 length 及使用 easing 扭曲 Y 軸的工作。

RotateYTo(VisualElement, Double, UInt32, Easing)

傳回透過 opacity 耗費時間 length 及使用 easing 扭曲 X 軸的工作。

ScaleTo(VisualElement, Double, UInt32, Easing)

傳回將 view 所指定 VisualElement 縮放至絕對縮放比例 scale 的工作。

ScaleXTo(VisualElement, Double, UInt32, Easing)

允許選擇日期的 View

ScaleYTo(VisualElement, Double, UInt32, Easing)

允許選擇日期的 View

TranslateTo(VisualElement, Double, Double, UInt32, Easing)

將項目 TranslationX 和 TranslationY 屬性,從其目前的值動畫顯示為新值。 這可確保輸入配置在與視覺效果配置相同的位置。

HasVisualStateGroups(VisualElement)

如果 element 具有一或多個與其建立關聯的視覺狀態群組,則傳回 true。 否則傳回 false

適用於