Most visited

Recently visited

Added in API level 11

CalendarView

public class CalendarView
extends FrameLayout

java.lang.Object
   ↳ android.view.View
     ↳ android.view.ViewGroup
       ↳ android.widget.FrameLayout
         ↳ android.widget.CalendarView


此课程是用于显示和选择日期的日历小部件。 此日历支持的日期范围是可配置的。

这个小部件的确切外观和交互模型在操作系统版本和主题(例如Holo与Material)之间可能会有所不同,但通常用户可以通过点击它来选择日期,并可以将日历滚动或拖动到所需的日期。

Summary

Nested classes

interface CalendarView.OnDateChangeListener

用于指示用户更改日期的回调。

XML attributes

android:dateTextAppearance The text appearance for the day numbers in the calendar grid. 
android:firstDayOfWeek The first day of week according to Calendar
android:focusedMonthDateColor This is deprecated. The color for the dates of the focused month.

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号focusedMonthDateColor

android:maxDate The maximal date shown by this calendar view in mm/dd/yyyy format. 
android:minDate The minimal date shown by this calendar view in mm/dd/yyyy format. 
android:selectedDateVerticalBar This is deprecated. Drawable for the vertical bar shown at the beginning and at the end of the selected date.

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号selectedDateVerticalBar

android:selectedWeekBackgroundColor This is deprecated. The background color for the selected week.

可能是对“ @[+][package:]type:name ”形式的其他资源的引用,也可能是对“ @[+][package:]type:name ”形式的主题属性的 ?[package:][type:]name

颜色值可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”的形式。

这对应于全局属性资源符号selectedWeekBackgroundColor

android:showWeekNumber This is deprecated. Whether do show week numbers.

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号showWeekNumber

android:shownWeekCount This is deprecated. The number of weeks to be shown.

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号shownWeekCount

android:unfocusedMonthDateColor This is deprecated. The color for the dates of an unfocused month.

可能是对其他资源的引用,形式为“ @[+][package:]type:name ”,也可能是“ ?[package:][type:]name ”形式的主题属性。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号unfocusedMonthDateColor

android:weekDayTextAppearance The text appearance for the week day abbreviation in the calendar header. 
android:weekNumberColor This is deprecated. The color for the week numbers.

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可能是颜色值,形式为“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”。

这对应于全局属性资源符号weekNumberColor

android:weekSeparatorLineColor This is deprecated. The color for the separator line between weeks.

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

颜色值可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”的形式。

这对应于全局属性资源符号weekSeparatorLineColor

Inherited XML attributes

From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View

Inherited constants

From class android.view.ViewGroup
From class android.view.View

Inherited fields

From class android.view.View

Public constructors

CalendarView(Context context)
CalendarView(Context context, AttributeSet attrs)
CalendarView(Context context, AttributeSet attrs, int defStyleAttr)
CalendarView(Context context, AttributeSet attrs, int defStyleAttr, int defStyleRes)

Public methods

CharSequence getAccessibilityClassName()

返回此对象的类名称以用于辅助功能。

long getDate()

从1970年1月1日00:00:00开始,以 getDefault()时区为单位获取所选日期(以毫秒为单位)。

int getDateTextAppearance()

获取日历日期的文本外观。

int getFirstDayOfWeek()

获取每周的第一天。

int getFocusedMonthDateColor()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

long getMaxDate()

getDefault()时区1970年1月1日00:00:00起,以毫秒为单位获取此 CalendarView支持的最大日期。

long getMinDate()

获取此 CalendarView支持的最小日期,以毫秒为单位,自1970年1月1日00:00:00开始,时区为 getDefault()

Drawable getSelectedDateVerticalBar()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

int getSelectedWeekBackgroundColor()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

boolean getShowWeekNumber()

此方法在API级别24中已弃用。不再由Material-style CalendarView使用。

int getShownWeekCount()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

int getUnfocusedMonthDateColor()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

int getWeekDayTextAppearance()

获取日历标题的星期几缩写的文本外观。

int getWeekNumberColor()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

int getWeekSeparatorLineColor()

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setDate(long date, boolean animate, boolean center)

从1970年1月1日00:00:00开始,以 getDefault()时区为单位设置所选日期(以毫秒为单位)。

void setDate(long date)

从1970年1月1日00:00:00开始,在 getDefault()时区中设置所选日期(以毫秒为单位)。

void setDateTextAppearance(int resourceId)

设置日历日期的文字外观。

void setFirstDayOfWeek(int firstDayOfWeek)

设置每周的第一天。

void setFocusedMonthDateColor(int color)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setMaxDate(long maxDate)

设置此 CalendarView支持的最大日期,以毫秒为单位,自1970年1月1日00:00:00开始,时区为 getDefault()

void setMinDate(long minDate)

设置此 CalendarView支持的最小日期,以毫秒为单位,自1970年1月1日00:00:00开始,位于 getDefault()时区。

void setOnDateChangeListener(CalendarView.OnDateChangeListener listener)

设置要在选定日期更改时通知侦听器。

void setSelectedDateVerticalBar(int resourceId)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setSelectedDateVerticalBar(Drawable drawable)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setSelectedWeekBackgroundColor(int color)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setShowWeekNumber(boolean showWeekNumber)

此方法在API级别24中已弃用。不再由Material-style CalendarView使用。

void setShownWeekCount(int count)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setUnfocusedMonthDateColor(int color)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setWeekDayTextAppearance(int resourceId)

设置日历标题的星期几缩写的文本外观。

void setWeekNumberColor(int color)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

void setWeekSeparatorLineColor(int color)

此方法在API级别23中已弃用。不再由Material-style CalendarView使用。

Protected methods

void onConfigurationChanged(Configuration newConfig)

当应用程序使用的资源的当前配置发生更改时调用。

Inherited methods

From class android.widget.FrameLayout
From class android.view.ViewGroup
From class android.view.View
From class java.lang.Object
From interface android.view.ViewParent
From interface android.view.ViewManager
From interface android.graphics.drawable.Drawable.Callback
From interface android.view.KeyEvent.Callback
From interface android.view.accessibility.AccessibilityEventSource

XML attributes

android:dateTextAppearance

日历网格中日期数字的文字外观。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 dateTextAppearance

相关方法:

android:firstDayOfWeek

根据 Calendar的第一天。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 firstDayOfWeek

相关方法:

android:focusedMonthDateColor

这已被弃用。
关注月份的日期颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 focusedMonthDateColor

相关方法:

android:maxDate

此日历视图以mm / dd / yyyy格式显示的最大日期。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 maxDate

相关方法:

android:minDate

此日历视图以mm / dd / yyyy格式显示的最小日期。

必须是字符串值,使用'\\;' 转义字符如'\\ n'或'\\ uxxxx'作为unicode字符。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 minDate

相关方法:

android:selectedDateVerticalBar

这已被弃用。
对于所选日期开始和结束时显示的垂直条可绘制。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 selectedDateVerticalBar

相关方法:

android:selectedWeekBackgroundColor

这已被弃用。
所选周的背景颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

颜色值可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”的形式。

这对应于全局属性资源符号 selectedWeekBackgroundColor

相关方法:

android:showWeekNumber

这已被弃用。
是否显示周数。

必须是布尔值,可以是“ true ”或“ false ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 showWeekNumber

相关方法:

android:shownWeekCount

这已被弃用。
要显示的周数。

必须是整数值,例如“ 100 ”。

这也可能是对包含此类型值的资源(形式为“ @[package:]type:name ”)或主题属性(形式为“ ?[package:][type:]name ”)的 ?[package:][type:]name

这对应于全局属性资源符号 shownWeekCount

相关方法:

android:unfocusedMonthDateColor

这已被弃用。
未聚焦月份日期的颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 unfocusedMonthDateColor

相关方法:

android:weekDayTextAppearance

日历标题中的星期缩写的文本外观。

必须是另一个资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

这对应于全局属性资源符号 weekDayTextAppearance

相关方法:

android:weekNumberColor

这已被弃用。
周数的颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 weekNumberColor

相关方法:

android:weekSeparatorLineColor

这已被弃用。
星期之间分隔线的颜色。

可能是另一种资源的引用,其形式为“ @[+][package:]type:name ”,或者其形式为“一个主题属性 ?[package:][type:]name ”。

可以是“ #rgb ”,“ #argb ”,“ #rrggbb ”或“ #aarrggbb ”形式的颜色值。

这对应于全局属性资源符号 weekSeparatorLineColor

相关方法:

Public constructors

CalendarView

Added in API level 11
CalendarView (Context context)

Parameters
context Context

CalendarView

Added in API level 11
CalendarView (Context context, 
                AttributeSet attrs)

Parameters
context Context
attrs AttributeSet

CalendarView

Added in API level 11
CalendarView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr)

Parameters
context Context
attrs AttributeSet
defStyleAttr int

CalendarView

Added in API level 21
CalendarView (Context context, 
                AttributeSet attrs, 
                int defStyleAttr, 
                int defStyleRes)

Parameters
context Context
attrs AttributeSet
defStyleAttr int
defStyleRes int

Public methods

getAccessibilityClassName

Added in API level 23
CharSequence getAccessibilityClassName ()

返回此对象的类名称以用于辅助功能。 如果子类正在实现的东西应该被视为一个全新的视图类,当它被可访问性使用时,子类只应该覆盖这个子类,与它所源自的类无关。 这用于填写AccessibilityNodeInfo.setClassName

Returns
CharSequence

getDate

Added in API level 11
long getDate ()

从1970年1月1日00:00:00开始,以 getDefault()时区为单位获取所选日期(以毫秒为单位)。

Returns
long The selected date.

getDateTextAppearance

Added in API level 16
int getDateTextAppearance ()

获取日历日期的文本外观。

相关XML属性:

Returns
int The text appearance resource id.

getFirstDayOfWeek

Added in API level 11
int getFirstDayOfWeek ()

获取每周的第一天。

相关XML属性:

Returns
int The first day of the week conforming to the CalendarView APIs.

也可以看看:

getFocusedMonthDateColor

Added in API level 16
int getFocusedMonthDateColor ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取关注月份中日期的颜色。

相关XML属性:

Returns
int The focused month date color.

getMaxDate

Added in API level 11
long getMaxDate ()

getDefault()时区1970年1月1日00:00:00起,以毫秒为单位获取此 CalendarView支持的最大日期。

注意:默认的最大日期是01/01/2100。

相关XML属性:

Returns
long The maximal supported date.

getMinDate

Added in API level 11
long getMinDate ()

getDefault()时区1970年1月1日00:00:00以毫秒为单位获取此 CalendarView支持的最小日期。

注意:默认的最短日期是01/01/1900。

相关XML属性:

Returns
long The minimal supported date.

getSelectedDateVerticalBar

Added in API level 16
Drawable getSelectedDateVerticalBar ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取所选日期开始和结束时显示的竖线的drawable。

Returns
Drawable The vertical bar drawable.

getSelectedWeekBackgroundColor

Added in API level 16
int getSelectedWeekBackgroundColor ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取所选周的背景颜色。

相关XML属性:

Returns
int The week background color.

getShowWeekNumber

Added in API level 11
boolean getShowWeekNumber ()

此方法在API级别24中已弃用。
Material-style CalendarView不再使用它。

获取是否显示星期编号。

相关XML属性:

Returns
boolean True if showing the week number.

getShownWeekCount

Added in API level 16
int getShownWeekCount ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取要显示的周数。

相关XML属性:

Returns
int The shown week count.

getUnfocusedMonthDateColor

Added in API level 16
int getUnfocusedMonthDateColor ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取未聚焦月份中日期的颜色。

相关XML属性:

Returns
int A not focused month date color.

getWeekDayTextAppearance

Added in API level 16
int getWeekDayTextAppearance ()

获取日历标题的星期几缩写的文本外观。

相关XML属性:

Returns
int The text appearance resource id.

getWeekNumberColor

Added in API level 16
int getWeekNumberColor ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取周数的颜色。

相关XML属性:

Returns
int The week number color.

getWeekSeparatorLineColor

Added in API level 16
int getWeekSeparatorLineColor ()

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

获取星期之间分隔线的颜色。

相关XML属性:

Returns
int The week separator color.

setDate

Added in API level 11
void setDate (long date, 
                boolean animate, 
                boolean center)

设置自1970年1月1日起在 getDefault()时区的00:00:00以毫秒为单位的所选日期。

Parameters
date long: The date.
animate boolean: Whether to animate the scroll to the current date.
center boolean: Whether to center the current date even if it is already visible.
Throws
IllegalArgumentException of the provided date is before the minimal or after the maximal date.

也可以看看:

setDate

Added in API level 11
void setDate (long date)

从1970年1月1日00:00:00开始,以 getDefault()时区为单位设置所选日期(以毫秒为单位)。

Parameters
date long: The selected date.
Throws
IllegalArgumentException of the provided date is before the minimal or after the maximal date.

也可以看看:

setDateTextAppearance

Added in API level 16
void setDateTextAppearance (int resourceId)

设置日历日期的文字外观。

相关XML属性:

Parameters
resourceId int: The text appearance resource id.

setFirstDayOfWeek

Added in API level 11
void setFirstDayOfWeek (int firstDayOfWeek)

设置每周的第一天。

相关XML属性:

Parameters
firstDayOfWeek int: The first day of the week conforming to the CalendarView APIs.

也可以看看:

setFocusedMonthDateColor

Added in API level 16
void setFocusedMonthDateColor (int color)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置关注月份日期的颜色。

相关XML属性:

Parameters
color int: The focused month date color.

setMaxDate

Added in API level 11
void setMaxDate (long maxDate)

设置此 CalendarViewgetDefault()时区自1970年1月1日00:00:00以来的毫秒中支持的最大日期。

相关XML属性:

Parameters
maxDate long: The maximal supported date.

setMinDate

Added in API level 11
void setMinDate (long minDate)

设置此 CalendarView支持的最小日期,以毫秒为单位,自1970年1月1日00:00:00开始,位于 getDefault()时区。

相关XML属性:

Parameters
minDate long: The minimal supported date.

setOnDateChangeListener

Added in API level 11
void setOnDateChangeListener (CalendarView.OnDateChangeListener listener)

设置要在选定日期更改时通知侦听器。

Parameters
listener CalendarView.OnDateChangeListener: The listener to be notified.

setSelectedDateVerticalBar

Added in API level 16
void setSelectedDateVerticalBar (int resourceId)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置所选日期开始和结束时显示的垂直条的绘图。

相关XML属性:

Parameters
resourceId int: The vertical bar drawable resource id.

setSelectedDateVerticalBar

Added in API level 16
void setSelectedDateVerticalBar (Drawable drawable)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置所选日期开始和结束时显示的垂直条的绘图。

相关XML属性:

Parameters
drawable Drawable: The vertical bar drawable.

setSelectedWeekBackgroundColor

Added in API level 16
void setSelectedWeekBackgroundColor (int color)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置所选星期的背景颜色。

相关XML属性:

Parameters
color int: The week background color.

setShowWeekNumber

Added in API level 11
void setShowWeekNumber (boolean showWeekNumber)

此方法在API级别24中已弃用。
Material-style CalendarView不再使用它。

设置是否显示星期编号。

相关XML属性:

Parameters
showWeekNumber boolean: True to show the week number.

setShownWeekCount

Added in API level 16
void setShownWeekCount (int count)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置要显示的星期数。

相关XML属性:

Parameters
count int: The shown week count.

setUnfocusedMonthDateColor

Added in API level 16
void setUnfocusedMonthDateColor (int color)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

为未聚焦的月份设置日期的颜色。

相关XML属性:

Parameters
color int: A not focused month date color.

setWeekDayTextAppearance

Added in API level 16
void setWeekDayTextAppearance (int resourceId)

设置日历标题的星期几缩写的文本外观。

相关XML属性:

Parameters
resourceId int: The text appearance resource id.

setWeekNumberColor

Added in API level 16
void setWeekNumberColor (int color)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

设置星期编号的颜色。

相关XML属性:

Parameters
color int: The week number color.

setWeekSeparatorLineColor

Added in API level 16
void setWeekSeparatorLineColor (int color)

此方法在API级别23中已弃用。
Material-style CalendarView不再使用它。

为星期之间的分隔线设置颜色。

相关XML属性:

Parameters
color int: The week separator color.

Protected methods

onConfigurationChanged

Added in API level 11
void onConfigurationChanged (Configuration newConfig)

当应用程序使用的资源的当前配置发生更改时调用。 您可以使用它来决定何时重新加载可根据方向和其他配置特性更改的资源。 你只需要使用这个,如果你不依靠正常Activity机制在配置更改重新创建活动实例。

Parameters
newConfig Configuration: The new resource configuration.

Hooray!