# GraffitiDateTimePicker
Class Inherits GraffitiSuite.BaseCanvas
## About
GraffitiDateTimePicker is an advanced chronological selector that combines both a date picker and time picker in to a single component. It has a wide variety of features including complete color customization, and views for time, month, year, and decade.
## Preview
Previous
Next
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| True | True |
### Desktop
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Attributes
| Name | Value |
| --- | --- |
| DefaultEvent | "SelectionChanged" |
## Enumerations
| Name | Value | Description |
| --- | :---: | --- |
| DaysOfWeek | Sunday <br> Monday <br> Tuesday <br> Wednesday <br> Thursday <br> Friday <br> Saturday | |
| SelectionTypes | Single <br> Multiple <br> Range | |
| ViewTypes | Month <br> Year <br> Decade <br> Time | |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| DateClick | NewDate as DateTime | (None) | The user clicked on a date. |
| MonthClick | theMonth as Integer | (None) | The user clicked on a month. |
| MouseOverDate | OverDate as DateTime | (None) | The user moved their mouse over a date. |
| MouseOverMonth | theMonth as Integer | (None) | The user moved their mouse over a month. |
| MouseOverYear | theYear as Integer | (None) | The user moved their mouse over a year. |
| Open | (None) | (None) | |
| SelectionChanged | (None) | (None) | The user has select or deselected dates. |
| TimeChange | Hour as Integer <br> Minute as Integer | (None) | The user has changed the time values. |
| YearClick | theYear as Integer | (None) | The user has clicked a year. |
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| Sub | Deselect | (None) | |
| Sub | DeselectAll | (None) | Deselects all selected dates. |
| Sub | NextMonth | (None) | Navigate to the next month. |
| Sub | NextYear | (None) | Navigate to the next year. |
| Sub | PreviousMonth | (None) | Navigate to the previous month. |
| Sub | PreviousYear | (None) | Navigate to the previous year. |
| Sub | SelectValue | (None) | Adds a date to the selection if multiple selections are possible, otherwise sets the current selection to theDate. |
| Sub | SetTime | (None) | Sets the displayed time to the specified value. |
| Sub | SetTime | (None) | Sets the displayed time to the specified value. |
| Sub | ShowDate | (None) | Switches to theView type and brings theDate in to view. |
| Function | Values | As | Returns an array of the selected dates. |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| ArrowColor | Color | Nil | Color of the arrows to navigate. |
| ArrowColorHover | Color | Nil | Color of the navigation arrows when hovered. |
| ArrowColorHoverBG | Color | Nil | Background color of navigation arrows when hovered. |
| BGColor | Color | Nil | Background color for all views. |
| BorderSize | Integer | Nil | Size of padding around the outside of the views. |
| CurrentDateBGColor | Color | Nil | Background color of current date in view. |
| DaysBold | Boolean | Nil | Display days in bold. |
| DaysFontName | String | Nil | Font used to draw days. |
| DaysFontSize | Integer | Nil | Font size for drawing days. |
| DaysItalic | Boolean | Nil | Display days italicized. |
| DaysTextColor | Color | Nil | Color of days. |
| DaysUnderline | Boolean | Nil | Underline days. |
| FirstDayOfWeek | DaysOfWeek | Nil | Sets the first day of the calendar week |
| HeaderBGColor | Color | Nil | Background color of the view header area. |
| HeaderBold | Boolean | Nil | Make header text bold. |
| HeaderCornerRadius | Integer | Nil | Draw rounded corners on header background> |
| HeaderFontName | String | Nil | Font name used to draw header text. |
| HeaderFontSize | Integer | Nil | Size of font in header. |
| HeaderItalic | Boolean | Nil | Italicize header text. |
| HeaderUnderline | Boolean | Nil | Underline header text. |
| Locale_Days | String | Nil | Text to use for days names. |
| Locale_Months | String | Nil | Text to use for month names. |
| LockView | Boolean | Nil | When true, does not allow the user to navigate between views. |
| MonthTextColor | Color | Nil | Text color of month names. |
| Private | As | = | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | = | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | = | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | | DateTime | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | = | |
| Private | As | = | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | = | |
| Private | As | = | |
| Private | As | Nil | |
| Private | As | Nil | |
| Private | As | Nil | |
| SelectedDateBackground | Color | Nil | Background color of currently selected dates. |
| SelectedDateText | Color | Nil | Foreground color of selected dates. |
| SelectionType | SelectionTypes | Nil | Sets the selection type, either Single or Range. |
| ShowNavigation | Boolean | Nil | Draws buttons for navigating from month-to-month, year-to-year, etc. |
| ShowViewButton | Boolean | Nil | Draws the button for navigation between calendar views. IE : Decade, Year, Month, Time. |
| Time24Hour | Boolean | Nil | Displays time in 24-hour instead of 12-hour with AM/PM when true. |
| TimeHeader | String | Nil | Text to display in the Time view header. |
| TimeTextSize | Integer | Nil | Size of the time text. |
| UseCustomColors | Boolean | Nil | Overrides default colors with those from properties. |
| ViewDate | DateTime | Nil | The date that is currently being viewed in the control. |
| ViewSelectorColor | Color | Nil | Color to draw the view selector icon. |
| ViewSelectorHoverBGColor | Color | Nil | Color to draw the background of the view selector icon when hovered. |
| ViewSelectorHoverColor | Color | Nil | Color to draw the view selector icon when hovered. |
| ViewType | ViewTypes | Nil | Sets or retrieves the current view type. |
| WeekdayBold | Boolean | Nil | Sets whether the week day names should be bold. |
