new Options()
Every option of the Schedule.Options type has associated a property of the control. For instance, the option:
allowActions {string}, customizes the actions the user can perform once the user clicks or touches the controlis associated with the property:
AllowActions {string}, customizes the actions the user can perform once the user clicks or touches the controlwhich means that the following statements are equivalent:
oSchedule.Options = {allowActions: "scroll"}where oSchedule is an object of Schedule type
oSchedule.SetOptions({allowActions: "scroll"})
oSchedule.AllowActions = "scroll"
oSchedule.SetAllowActions("scroll")
Members
(static) allowActions :string
"action(shortcut,shortcut,...),action(shortcut,shortcut,...)..."where
- "action", indicates the name of the action. The "action" can have any of the following values:
- "scroll", scrolls the control's content by drag. The "scroll" action allows flags such as:
- [view], specifies that the "scroll" is possible once the user clicks the view
- [timeScale], specifies that the "scroll" is possible once the user clicks the time-scale
- "zoom", zooms the control's content at dragging-point.
- "fit", fits the drag-area into the control's client area.
- "select", selects events by drag
- "drag-drop", carries out the drag and drop of the ui-event (the ui-event can be dropped inside or outside of the control). The ExDrop(event, data) method of the target HTML element is invoked once the user drops the ui-event. The event parameter holds information about the mouse/touch event once the ui-event has been dropped. The data parameter holds information about the source-object that initiated the drag and drop operation, as an object of {object,source,client,shape} type.
- "day-resize", resizes the day by drag and drop (not available if the control is read-only)
- "group-resize", resizes the group by drag and drop (not available if the control is read-only)
- "group-drag", changes the group's position by drag and drop (not available if the control is read-only)
- "create", creates event by drag (not available if the control is read-only)
- "move", moves or resizes events by drag (not available if the control is read-only)
- "scroll", scrolls the control's content by drag. The "scroll" action allows flags such as:
- "shortcut", defines the event's button or/and the modifier-keys that are required to perform the action. The "shortcut" is a combination of none, one or more of the following values:
- "Shift", indicates that the SHIFT key is pressed
- "Ctrl" or "Control", indicates that the CTRL key is pressed
- "Alt" or "Menu", indicates that the ALT key is pressed
- "Meta" , indicates that the META key is pressed
- "LButton", specifies that the mouse's left-button is pressed
- "RButton", specifies that the mouse's right-button is pressed
- "MButton", specifies that the mouse's middle/wheel-button is pressed
- "Long", specifies that the action requires a "long" click or touch before it begins
- "Double", specifies that the action requires a "double" click before it begins (this flag is available for non-dragable actions only such as "edit")
- "+", indicates AND between values
Type:
- string
Example
null {null}, indicates the control's default allowActions value
"" {string}, specifies that no operation is allowed once the user clicks or touches the control
"scroll" {string}, specifies that only "scroll" operation is allowed, no matter of the event's button or modifier-keys is pressed.
allowActions
(static) allowAllDayEventScroll :null|number|Array.<number>
- null {null}, the all-day header displays events as many as it fits
- positive-number {number}, the all-day header always displays an exact number of levels
- negative-number {number}, the all-day header displays up to specified number of levels
- [min,max] {array}, indicates a two-elements array of [min,max] type that defines the minimum and maximum number of levels, where min must be zero or any positive number, while max can be null, negative (up to) or positive number(fixed)
Type:
- null | number | Array.<number>
Example
null {null}, the all-day header displays events as many as it fits
3 {number}, indicates that the all-day header always displays 3 levels
-3 {number}, indicates that the all-day header can display up to 3 levels
[1] {array}, indicates 1 to unlimited levels
[1,4] {array}, always displays 4 levels
[1,-4] {array}, displays from 1 to 4 levels
allowAllDayEventScroll
(static) allowMoveEventToOtherGroup :boolean
The control displays groups if:
- showGroupingEvents option is true
- The Groups collection has visible elements. By default, the Groups collection contains no Group objects
Type:
- boolean
Example
false {boolean}, indicates that the event can not be moved from a group to another
true {boolean}, indicates that the event can be moved from a group to another
allowMoveEventToOtherGroup
(static) allowMultiDaysEvent :boolean
Type:
- boolean
Example
false {boolean}, the user can create or resize just single-date events only
true {boolean}, the user can create multi-dates events by drag and drop (create or resize)
allowMultiDaysEvent
(static) allowUndoRedo :boolean
Type:
- boolean
Example
false {boolean}, the Undo/Redo feature is disabled (default)
true {boolean}, enables the Undo/Redo feature.
allowUndoRedo
(static) applyGroupingColors :boolean
Type:
- boolean
Example
false {boolean}, no eventShape (option of Group) is applied to any event
true {boolean}, the group's eventShape is applied on the event while the event has no custom shape
applyGroupingColors
(static) background :BackgroundOptions
Type:
(static) calendar :object
- tfi {(string|object)}, holds the font attributes for captions within the control. The tfi field can be defined using a string representation such as "b monospace 16" or as an object such as {bold: true, fontName: "monospace", fontSize: 16}.
- mode {exontrol.Calendar.ModeEnum}, specifies the orientation the calendar displays the days of the weeks.
- flow {exontrol.Calendar.FlowEnum}, determines whether the months gets arranged from left to right or top to bottom.
- autoSize {exontrol.Calendar.AutoSizeEnum}, determines whether the size of the calendar's date is fixed, or relative to the current font or client area.
- smoothSel {number}, defines the time in ms the calendar's selection goes from one state to another.
- locked {boolean}, indicates whether the control is locked(protected) or unlocked.
- selection {(null|Date|array)} , specifies the selected date(s).
- singleSel {exontrol.Calendar.SingleSelEnum}, specifies whether the control supports single, multiple, toggle selection.
- allowSwitchView {boolean}, specifies whether the user can switch the view (month or year).
- allowScrollByDrag {boolean}, specifies whether the user can scroll the control by drag.
- padCal {(number|string|array)}, specifies the padding to display the calendar.
- alignCal {exontrol.AlignEnum} aligns the calendar relative to the canvas.
- wheelChange {number}, specifies the amount the calendar scrolls when the user rolls the mouse wheel.
- minMonthX {number}, specifies the minimum number of months horizontally displayed.
- maxMonthX {number}, specifies the maximum number of months horizontally displayed.
- minMonthX {number}, specifies the minimum number of months vertically displayed.
- maxMonthY {number}, specifies the maximum number of months vertically displayed.
- pad {(number|string|array)}, specifies the padding to be applied on dates of the calendar.
- dayLabel {string}, defines a HTML string that can include expression fields (<%...%>) to display the date while the calendar is in day-view.
- dayAlign {exontrol.DrawTextFormatEnum}, aligns the date's label, while the calendar is in day-view.
- dayFixedWidth {number}, defines the width of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
- dayFixedHeight {number}, defines the height of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
- dayWeekHeader {boolean}, specifies whether the calendar shows the header to display the days of the week (day-view only).
- dayWeekLabel {string}, defines the ex-HTML label to show the days of the week into the calendar's header (day-view only).
- dayWeekNoHeader {boolean}, specifies whether the calendar shows the header to display week-number (day-view only).
- dayWeekNoLabel {string}, defines the ex-HTML label to show the week-number into the calendar's header (day-view only).
- dayMonthHeader {boolean}, specifies whether the calendar shows the header to display month's name (day-view only).
- dayMonthLabel {string}, defines the ex-HTML label to show the month-name into the calendar's header (day-view only).
- dayMonthAlign {exontrol.DrawTextFormatEnum}, aligns the month's label, while the calendar is in day-view.
- dayNonMonth {boolean}, specifies whether the calendar displays the dates that are not part of the current month.
- dayNonMonthLabel {string}, the ex-HTML label to show the dates that are not part of the current month (day-view only).
- dayWeekAllLabel {string}, defines the ex-HTML label to show the first day of the month on the top-left corner of the calendar, when the week-number and week-days headers are present (day-view only).
- monthLabel {string}, specifies the ex-HTML string that can include expression fields (<%...%>) to display the month while the calendar is in month-view.
- monthAlign {exontrol.DrawTextFormatEnum}, aligns the month's label, while the calendar is in month-view.
- monthYearAlign {exontrol.DrawTextFormatEnum}, aligns the year's label, while the calendar is in month-view.
- yearLabel {string}, specifies the ex-HTML string that can include expression fields (<%...%>) to display the year while the calendar is in year-view.
- yearAlign {exontrol.DrawTextFormatEnum}, aligns the year's label, while the calendar is in year-view.
- yearRangeAlign {exontrol.DrawTextFormatEnum}, aligns the label that displays the range of years, while the calendar is in year-view.
- shapes {string}, defines the shapes each part of the control can display. The shapes field customizes the control's visual appearance.
- hlShapes {string}, field defines the shape(s) to be applied on a part of the control, when it requires to be highlighted
- cursors {string}, specifies the mouse cursor to be displayed when pointing over a part of the control.
Type:
- object
Example
null {null} or {} {object}, no options to apply on the calenda
{locale: "de"} {object}, changes the calendar's locale to German
{tfi: "bold <fgcolor blue>"} {object}, shows days of the month bolded in blue
calendar
(static) createEventLabel :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDateTime) {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
null {null}, the control's DefaultEventLongLabel/DefaultEventShortLabel property defines the event's label while the user creates it by drag and drop
"" {string}, no label is shown for event to create
"Start: <%=%1%><br>End: <%=%2%>" {string}, displays the starting margin of the even on the first line, while on the second line it displays the ending point of the event
"Duration: <%=((1:=int(0:= %7)) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" {string}, displays the duration of the event in days, hours and minutes
createEventLabel
(static) cursors :string
"cursor(part),cursor(part),..."where:
- "cursor", defines the CSS mouse cursor to display while cursor hovers the part
- "part", defines the name of the part the cursor is applied on (as defined below)
- "date", defines the mouse-cursor when the mouse pointer hovers the date (any part)
- "date-header", defines the mouse-cursor when the mouse pointer hovers the header's date
- "grouping-button", defines the mouse-cursor when the mouse pointer hovers the header's grouping-button
- "date-grouping-header", defines the mouse-cursor when the mouse pointer hovers the date's grouping-header part
- "date-all-day-header", defines the mouse-cursor when the mouse pointer hovers the date's all-day header
- "date-all-day-scroll-button", defines the mouse-cursor when the mouse pointer hovers the date's scroll-button of the all-day header
- "date-all-day-scroll-wheel", defines the mouse-cursor when the mouse pointer hovers the date's scroll-wheel of the all-day header (the scroll-wheel zone is the portion of the all-day header where user can scroll the events using the mouse wheel)
- "date-timeScale", defines the mouse-cursor when the mouse pointer hovers the date's time-scale part
- "resize-group", defines the mouse-cursor when the mouse pointer hovers the group's resize margin
- "event", defines the mouse-cursor when the mouse pointer hovers any movable event
- "create", defines the mouse-cursor to create new events by drag and drop
- "drag-drop", defines the cursor while the event is being dragged using the "drag-drop" action
- "timeScale", defines the mouse-cursor when the mouse pointer hovers the control's time-scale header
- "resize-h" (resize-event-horizontal), defines the mouse-cursor when the mouse pointer hovers the all-day event's start and end margins
- "resize-v" (resize-event-vertical), defines the mouse-cursor when the mouse pointer hovers the event's start and end margins
- "anchor" (hyperlink), defines the mouse-cursor when the mouse pointer hovers the anchor (the <a id;options> ex-HTML part marks an anchor or hyperlink element) (@since 2.2)
- "long", specifies the mouse-cursor to be shown as soon as a "long" click or touch action begins (see allowActions field)
Type:
- string
Example
"pointer(xxx,yy)" {string}, indicates that the "pointer" mouse cursor is shown while cursor hovers any "xxx" or "yyy" part of the control
cursors
(static) dayEndTime :string
Type:
- string
Example
null {null}, every day ends at 4:00 PM
"17:00" {string}, the day ends at 05:00 PM
dayEndTime
(static) dayStartTime :string
Type:
- string
Example
null {null}, every day starts at 8:00 AM
"07:00" {string}, the day starts at 07:00 AM
dayStartTime
(static) dayViewHeight :number
Type:
- number
Example
null {null} or -1 {number}, the day fits vertically the schedule view
128 {number}, the day within the schedule panel has a fixed height
dayViewHeight
(static) dayViewWidth :number
Type:
- number
Example
null {null} or -1 {number}, the day fits horizontally the schedule view
128 {number}, the day within the schedule panel has a fixed width
dayViewWidth
(static) defaultEventExtraLabel :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDateTime) {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
"" {string}, no extra label is shown
"<img>image</img> and text" {string}, the event displays the image and text. The image can be added using the exontrol.HTMLPicture.Add() method
"<%=%256%>", displays the event's start and end margins in a short format
defaultEventExtraLabel
(static) defaultEventLongLabel :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDateTime) {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
null {null} or undefined {undefined}, the default short-label is used ("<%=%256%>")
"" {string}, the short-label is hidden
"<img>image</img> and text" {string}, the event displays the image and text. The image can be added using the exontrol.HTMLPicture.Add() method
"<%=%256%>", displays the event's start and end margins in a short format
defaultEventLongLabel
(static) defaultEventShortLabel :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDatef {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
null {null} or undefined {undefined}, the default short-label is used ("<%=%256%>")
"" {string}, the short-label is hidden
"<img>image</img> and text" {string}, the event displays the image and text. The image can be added using the exontrol.HTMLPicture.Add() method
"<%=%256%>", displays the event's start and end margins in a short format
defaultEventShortLabel
(static) defaultEventToolTip :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDateTime) {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
null {null} or undefined {undefined}, the default-tooltip is used ("Start: <%=%1%><br>End: <%=%2%><br>Duration: <%=((1:=int(0:= %7)) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>")
"" {string}, no tooltip
"<img>image</img> and text" {string}, the image and text is being shown once the mouse pointer hovers the event. The image can be added using the exontrol.HTMLPicture.Add() method
"<%=%256%>", displays the event's start and end margins in a short format
defaultEventToolTip
(static) displayGroupingButton :boolean
The grouping button is displayed if:
- displayGroupingButton option is true
- showGroupingEvents option is true
- showGroupingEvents option is true
- The Groups collection has visible elements. By default, the Groups collection contains no Group objects
The control displays groups if:
Type:
- boolean
Example
false {boolean}, no grouping button is shown
true {boolean}, shows the grouping button within the date's header
displayGroupingButton
(static) events :array|object
- {array(any)}, defines multiple events, with specified options, as an array of [{EventOptions}] type
- {object}, defines multiple events, where each property(key) of the object defines the event with its options, of EventOptions type
Type:
- array | object
Example
events: [{start: "#1/1/2001 10:00#", end: "#1/1/2001 12:00#"}], {array} defines a single event
events:
{
"E1":
{
start: "#1/1/2001 10:00#",
end: "#1/1/2001 12:00#"
},
"E2":
{
start: "#1/1/2001 12:00#",
end: "#1/1/2001 14:00#",
visible: false
}
}, {object} defines two events "E1" and "E2"
events
(static) formatText :exontrol.DrawTextFormatEnum
- exTextAlignTop (0x00), justifies the text to the top of the rectangle
- exTextAlignLeft (0x00), aligns text to the left
- exTextAlignCenter (0x01), centers text horizontally in the rectangle
- exTextAlignRight (0x02), aligns text to the right
- exTextAlignVCenter (0x04), centers text vertically
- exTextAlignBottom (0x08), justifies the text to the bottom of the rectangle.
- exTextAlignMask (0x0F), specifies the mask for text's alignment.
- exTextWordBreak (0x10), breaks words. Lines are automatically broken between words if a word would extend past the edge of the rectangle specified by the lpRect parameter. A carriage return-line feed sequence also breaks the line. If this is not specified, output is on one line.
- exTextSingleLine (0x20), displays text on a single line only. Carriage returns and line feeds do not break the line.
- exTextExpandTabs (0x40), expands tab characters. The default number of characters per tab is eight.
- exPlainText (0x80), treats the text as plain text.
- exTextNoClip (0x0100), draws without clipping.
- exHTMLTextNoColors (0x0200), ignores the
and tags. - exTextCalcRect (0x0400), determines the width and height of the text.
- exHTMLTextNoTags (0x0800), ignores all HTML tags.
- exTextPathEllipsis (0x4000), for displayed text, replaces characters in the middle of the string with ellipses so that the result fits in the specified rectangle. If the string contains backslash (\) characters, exTextPathEllipsis preserves as much as possible of the text after the last backslash.
- exTextEndEllipsis (0x8000), for displayed text, if the end of a string does not fit in the rectangle, it is truncated and ellipses are added. If a word that is not at the end of the string goes beyond the limits of the rectangle, it is truncated without ellipses.
- exTextWordEllipsis (0x040000), truncates any word that does not fit in the rectangle and adds ellipses.
Type:
- exontrol.DrawTextFormatEnum
Example
null {null}, centers the caption
32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line caption
0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line caption right/bottom-aligned
formatText
(static) groups :array|object
- {string}, defines a single group with specified caption/identifier
- {array(any)}, defines multiple groups, with specified caption/identifier/options, as an array of [caption] or [{GroupOptions}] type
- {object}, defines multiple groups, where each property of the object defines a group with its options, of GroupOptions type
Type:
- array | object
Example
groups: "G1", {string} defines a single group with the identifier/caption "G1"
groups: ["G1",{caption: "G2", visible: true}], {array} defines two groups "G1" and "G2"
groups:
{
"G1":
{
},
"G2":
{
visible: true
},
"G3":
{
eventShape: "red",
visible: true
}
}, {object} defines three groups "G1", "G2" and "G3"
groups
(static) headerAllDayEventHeight :number
Type:
- number
Example
null {null}, the height of the event within the control's all-day header is the same as the size of the control's font (100%)
0 {number}, hides the all-day header
2 {number}, the height of the event within the control's all-day header is 2 times the size of the control's font
headerAllDayEventHeight
(static) headerDayHeight :number
Type:
- number
Example
null {null}, the height of the day's header is 1.5 times the size of the control's font (150%)
0 {number}, hides the day's header
2 {number}, the height of the day's header is 2 times the size of the control's font
headerDayHeight
(static) headerDayLongLabel :string
The ALT part of the label supports ex-HTLM tags such as (<b>, <i>, <fgcolor>, ...) and <%DATE%> tags as follows:
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, the date's header displays the label using default alternate-labels (and expression)
"" {string}, the date's header displays no date
"<%loc_ldate%>" {string}, displays the date in the long format using the current user regional and language settings
"<%d3%>, <%d%><|><%d2%>, <%d%><|><%d1%>, <%d%><|><%d%>" {string}, the date's header displays one, two or three letters for the week day based on the best fit
"<fgcolor red><%d3%>, <%d%><|><%d3%>, <%d%><=>month(value) = 1 ? 0 : 1" {string}, displays the date's header in red for January, and in black for the rest
headerDayLongLabel
(static) headerDayShortLabel :string
The ALT part of the label supports ex-HTLM tags such as (<b>, <i>, <fgcolor>, ...) and <%DATE%> tags as follows:
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, the date's header displays the label using default alternate-labels (and expression)
"" {string}, the date's header displays no date
"<%loc_ldate%>" {string}, displays the date in the long format using the current user regional and language settings
"<%d3%>, <%d%><|><%d2%>, <%d%><|><%d1%>, <%d%><|><%d%>" {string}, the date's header displays one, two or three letters for the week day based on the best fit
"<fgcolor red><%d3%>, <%d%><|><%d3%>, <%d%><=>month(value) = 1 ? 0 : 1" {string}, displays the date's header in red for January, and in black for the rest
headerDayShortLabel
(static) headerGroupHeight :number
Type:
- number
Example
0 {number}, hides the group's header
2 {number}, the height of the group's header is 2 times the size of the control's font
headerGroupHeight
(static) imageAlign :number
- 0, the image is on the left of the event's caption
- 1, the image is on the right of the event's caption
- 2, the image is on the top of the event's caption
- 3, the image is on the bottom of the event's caption
Type:
- number
Example
null {null}, the image is aligned left to the caption (default)
1 {number}, the image is displayed to the right of the event's caption
imageAlign
(static) imageSize :null|number|Array.<number>
- {null}, Indicates that the event's image is displayed as it is (full-sized).
- {number}, Specifies that the event's image is displayed into a square of giving size (same width and height). If 0 the event displays no image, if negative the event's image is stretched to giving square, else the event's picture is scaled to fit the giving rectangle.
- {number[]}, Specifies an array of [aspect-width,aspect-height] type that defines the limits for width or/and height. The aspect-width and aspect-height define the width/height of the event's picture to scale or stretch to.
Type:
- null | number | Array.<number>
Example
null {null}, Indicates that the event's image is displayed as it is (full-sized).
0 {number}, no image is displayed
64 {number}, the image is scaled to fit a 64 x 64 rectangle
-64 {number}, the image is strected to a 64 x 64 rectangle
[32,64] {array}, scales the image to the largest ratio-rectangle (32 x 64) that fits the client
[-32,-64] {array}, stretches the image to a 32 x 64 rectangle
imageSize
(static) locked :boolean
Type:
- boolean
Example
false {boolean}, unlocks the control (can select any event)
true {boolean}, locks the control (can't select any event)
locked
(static) longDateFormat :string
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, "<%loc_ldate%>"
"" {string}, nothing is displayed
"<%loc_ldate%>" {string}, displays the date in the long format using the current user regional and language settings
"<%mm%>/<%dd%>/<%yyyy%>" {string}, displays the date in mm/dd/yyyy format
longDateFormat
(static) longTimeFormat :string
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, "<%hh%>:<%nn%>:<%ss%> <%AM/PM%>"
"" {string}, nothing is displayed
"<%loc_time24%>" {string}, Indicates the time in 24 hours format without a time marker using the current user regional and language settings
"<%hh%>:<%nn%>:<%ss%>" {string}, displays the time in hh:nn:ss format
longTimeFormat
(static) markZones :array|object
- {string}, defines a single mark-zone with specified caption/identifier
- {array(any)}, defines multiple mark-zones, with specified caption/identifier/options, as an array of [caption] or [{MarkZoneOptions}] type
- {object}, defines multiple mark-zones, where each property of the object defines a mark-zone with its options, of MarkZoneOptions type
Type:
- array | object
Example
markZones: "Now", {string} defines a single mark-zone with the identifier/caption "Now"
markZones: ["Z1",{caption: "Z2", visible: false}], {array} defines two mark-zones "Z1" and "Z2" (hidden)
markZones:
{
"Z1":
{
},
"Z2":
{
},
"Z3":
{
shape:
{
pattern: 6,
patternColor: "lightgray"
},
visible: false
}
}, {object} defines three mark-zones "Z1", "Z2" and "Z3"
markZones
(static) markZones :array|object
- {string}, defines a single mark-zone with specified caption/identifier
- {array(any)}, defines multiple mark-zones, with specified caption/identifier/options, as an array of [caption] or [{MarkZoneOptions}] type
- {object}, defines multiple mark-zones, where each property of the object defines a mark-zone with its options, of MarkZoneOptions type
Type:
- array | object
Example
markZones: "Now", {string} defines a single mark-zone with the identifier/caption "Now"
markZones: ["Z1",{caption: "Z2", visible: false}], {array} defines two mark-zones "Z1" and "Z2" (hidden)
markZones:
{
"Z1":
{
},
"Z2":
{
},
"Z3":
{
shape:
{
pattern: 6,
patternColor: "lightgray"
},
visible: false
}
}, {object} defines three mark-zones "Z1", "Z2" and "Z3"
markZones
(static) misc :MiscellaneousOptions
Type:
(static) onResizeControl :exontrol.Schedule.OnResizeControlEnum
- exResizePanelLeft(0), specifies that the left panel of the control is resized, once the entire-control gets resized
- exResizePanelRight(1), specifies that the right panel of the control is resized, once the entire-control gets resized
- exDisableSplitter(128), disables the splitter, so the user can not resize the panels using the control's vertical split bar
- exHideSplitter(256), hides the splitter, so a single panel is visible at runtime (calendar or schedule view)
- exChangePanels(512), exchanges the content of the panels (the calendar panel is aligned to the right)
- exCalendarFit(1024), ensures that the calendar fits to the panel that hosts it
- exCalendarAutoHide(2048), turns on or off the calendar panel when the cursor leaves the panels
Type:
- exontrol.Schedule.OnResizeControlEnum
Example
128 or exontrol.Schedule.OnResizeControlEnum.exDisableSplitter {number}, disables the splitter, so the user can not resize the panels using the control's vertical split bar
768 or exontrol.Schedule.OnResizeControlEnum.exChangePanels | exontrol.Schedule.OnResizeControlEnum.exHideSplitter {number}, shows the schedule view only (hides the calendar panel)
onResizeControl
(static) onSelectDate :exontrol.Schedule.OnSelectDateEnum
- exFitSelToView (-1), changes the day's size and scrolls the view so the calendar's selection fits the schedule view
- exNoViewChange (0), no change/scroll occurs within the view
- exEnsureVisibleDate (1), scrolls the view to ensure that clicked date fits the schedule view
Type:
- exontrol.Schedule.OnSelectDateEnum
Example
null {null}, equivalent of -1 or exontrol.Schedule.OnSelectDateEnum.exFitSelToView
0 or exontrol.Schedule.OnSelectDateEnum.exNoViewChange {number}, no scroll / change occurs whitin the schedule view once the calendar's selection is changed
onSelectDate
(static) pad :number|Array.<number>|string
- {number} a numeric value, to pad horizontal and vertical size with the same value
- {(string|number[])} a "x,y" or [x,y] type to specify the padding on horizontal and vertical side
Type:
- number | Array.<number> | string
Example
null {null}, indicates that the default-padding field is used ([4,4])
0 {number}, indicates no padding
"8,4" {string}, increases the event's width with 2 * 8-pixels and event's height with 2 * 4-pixels
[8,4] {array}, increases the event's width with 2 * 8-pixels and event's height with 2 * 4-pixels
pad
(static) paneWidthLeft :number
Type:
- number
Example
null {null}, ignored
0 {number}, hides the left-panel
196 {number}, the size of the left-panel is set to 196
paneWidthLeft
(static) paneWidthRight :number
Type:
- number
Example
null {null}, ignored
0 {number}, hides the right-panel
196 {number}, the size of the right-panel is set to 196
paneWidthRight
(static) readOnly :boolean
Type:
- boolean
Example
false {boolean}, the user can edit or drag any event
true {boolean}, the user can not edit or drag the events
readOnly
(static) scrollBars :exontrol.ScrollBarsEnum
- exNoScroll (0), specifies that no scroll bars are shown (scroll is not allowed)
- exHorizontal (1), specifies that only horizontal scroll bars is shown
- exVertical (2), specifies that only vertical scroll bars is shown
- exBoth (3), specifies that both horizontal and vertical scroll bars are shown
- exDisableNoHorizontal (5), specifies that the horizontal scroll bar is always shown, it is disabled if it is unnecessary
- exDisableNoVertical (10), specifies that the vertical scroll bar is always shown, it is disabled if it is unnecessary
- exDisableBoth (15), specifies that both horizontal and vertical scroll bars are always shown, disabled if they are unnecessary
- exHScrollOnThumbRelease (0x100), specifies that the control's content is horizontally scrolled as soon as the user releases the thumb of the horizontal scroll bar (use this option to specify that the user scrolls the control's content when the thumb of the scroll box is released)
- exVScrollOnThumbRelease (0x200), specifies that the control's content is vertically scrolled as soon as the user releases the thumb of the vertical scroll bar (use this option to specify that the user scrolls the control's content when the thumb of the scroll box is released)
- exScrollOnThumbRelease (0x300), specifies that the control's content is scrolled as soon as the user releases the thumb of the horizontal scroll bar (use this option to specify that the user scrolls the control's content when the thumb of the scroll box is released)
- exHScrollEmptySpace (0x400), allows empty space, when the control's content is horizontally scrolled to the end
- exVScrollEmptySpace (0x800), allows empty space, when the control's content is vertically scrolled to the end
- exScrollEmptySpace (0xC00), allows empty space, when the control's content is scrolled to the end
- exExtendSBS (0x3000), specifies that the control's scroll-bars are visible only when cursor hovers the window. Also, the control's client area is extended on the scroll bars portion
- exMinSBS (0xC000), specifies that the control's scroll-bars are shown as minimized
- exHideSBS (0x10000), specifies that no scroll bars are shown (scroll is allowed)
Type:
- exontrol.ScrollBarsEnum
Example
0 or exontrol.ScrollBarsEnum.exNoScroll {number}, removes the control's scroll bars, so scroll is not allowed
15 or exontrol.ScrollBarsEnum.exDisableBoth {number}, the control always displays the scroll bars, and they are active only if scroll is possible
12291 or exontrol.ScrollBarsEnum.exBoth | exontrol.ScrollBarsEnum.exExtendSBS {number}, the control shows the scroll bars only if the cursor hovers the control, and the control scroll bars are hidden as soon as the cursor leaves the control
scrollBars
(static) scrollPos :object
x {number}, indicates the horizontal scroll-position.
y {number}, indicates the vertical scroll-position
Type:
- object
Example
{x: 100} {object}, scrolls horizontally to position 100
{x: 100, y: 50} {object}, scrolls horizontally to position 100, and vertically to 50
scrollPos
(static) selectEventStyle :number
- 0 {number}, the "select" shape is combined with the event's shape
- 1 {number}, the "select" shape is displayed on the event's background. The misc.padSelectEvent field specifies the space between the event's content and its selection border.
- 2 {number}, the "select" shape is displayed on the event's background, but it is shown using the event's primitive (rectangle, round, oval...). The misc.padSelectEvent field specifies the space between the event's content and its selection border.
Type:
- number
Example
null {null}, equivalent of 0 so the "select" shape is combined with the event's shape
1 {number}, the event's shape and color is not altered so the "select" shape is displayed on the event's background
selectEventStyle
(static) selection :any
- value {null}, clears the entire selection (unselect all)
- value {number}, selects an event giving index within the events collection
- value {string}, selects an event giving its identifier/key
- value {Event}, selects an event giving its reference
- value {Event}, selects all events within the control
- value {array}, specifies an array of [type] type, where type could be any number, string or Event type.
Type:
- any
- Since:
- 1.9
Example
null {null}, clears the entire selection
0 {number}, selects the event with the index 0
[0,"key"] {number}, selects the event with the index 0 and the event with the identifier/key "key"
selection
(static) shapes :string
"shape(part),shape(part),..."where:
- "shape", defines the shape to apply on the UI part as one of the following:
◦ any of 140 color names any browser supports (such as red, blue, green, ...)
◦ hexadecimal colors, is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between 00 and FF (such as #0000ff which defines a blue background)
◦ hexadecimal colors with transparency, is specified with: #RRGGBBAA, where AA (alpha) value must be between 00 and FF (such as #0000ff80 which defines a semi-transparent blue background)
◦ RGB colors, is specified with the RGB(red, green, blue) function. Each parameter (red, green, and blue) defines the intensity of the color and can be an integer between 0 and 255( such as rgb(0,0,255) that defines a blue background)
◦ RGBA colors, are an extension of RGB color values with an alpha channel as RGBA(red, green, blue, alpha) function, where the alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque) ( such as rgba(0,0,255,0.5) which defines a semi-transparent blue background)
◦ HSL colors, is specified with the HSL(hue, saturation, lightness) function, where hue is a degree on the color wheel (from 0 to 360) - 0 (or 360) is red, 120 is green, 240 is blue. saturation is a percentage value; 0% means a shade of gray and 100% is the full color. lightness is also a percentage; 0% is black, 100% is white. HSL stands for hue, saturation, and lightness - and represents a cylindrical-coordinate representation of colors (such as hsl(240, 100%, 50%) that defines a blue background)
◦ HSLA colors, are an extension of HSL color values with an alpha channel - which specifies the opacity of the object as HSLA(hue, saturation, lightness, alpha) function, where alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque) (such as hsla(240, 100%, 50%,0.5) that defines a semi-transparent blue background)
◦ a JSON representation of the shape object to apply (while it starts with { character, such as '{"normal": {"primitive": "RoundRect","fillColor":"black","tfi": {"fgColor": "white"}}}')
◦ specifies the name of the field within the exontrol.Shapes.Schedule object (while it starts with a lowercase letter, such as shevent which refers to exontrol.Shapes.Schedule.shevent shape)
◦ specifies the name of the field within the exontrol.Shapes object (while it starts with an uppercase letter, such as Button which refers to exontrol.Shapes.Button shape)
- "part", defines the name of the part the shape is applied on (as defined below)
- "date-frame", defines the visual-appearance for the frame around each date (schedule view only)
- "date-frame-select", defines the visual-appearance for the frame around each selected date (schedule view only)
- "dateAlt", defines the visual-appearance for alternate-date (schedule view only)
- "date-header", defines the visual-appearance for the date's header (schedule view only)
- "dateAlt-header", defines the visual-appearance for the alternate-date's header (schedule view only)
- "grouping-button", defines the visual-appearance for the header's grouping-button (schedule view only)
- "date-timeScale", defines the visual-appearance for the date's time-scale part (schedule view only)
- "date-grouping-header", defines the visual-appearance for the date's grouping-header (schedule view only)
- "date-all-day-header", defines the visual-appearance for the date's all-day-header (schedule view only)
- "date-all-day-scroll-button", defines the visual-appearance for scroll-butttons to display within the all-day header
- "uiHighlight", defines the visual-appearance to highlight the date that contains events (The showHighlightEvent option specifies whether the control highlights the dates that contain events)
- "calendar-uiHighlight", defines the visual-appearance to highlight the date that contains events (similar with uiHighlight but applied to calendar-panel only) (The showHighlightEvent option specifies whether the control highlights the dates that contain events)
- "event", defines the visual-appearance for all events within the control
- "event-drag", defines additional visual-appearance to apply on the event being dragged
- "mark-zone", defines the visual-appearance for all mark-zones within the control
- "select", defines the visual-appearance of selected-event
- "frameFit", defines the visual-appearance to display the frame while fitting objects into the control's client area by drag
- "frameSel", defines the visual appearance to display a frame while selecting objects by drag
- "timeScale", defines the visual appearance for control's time-scale
Type:
- string
Example
null {null}, specifies the default visual appearance
"" {string}, no shape (no visual appearance is applied to any part of the control)
"red(eventAlt)", "#FF0000(eventAlt)", "rgb(255,0,0)(eventAlt)", "rgba(255,0,0,1)(eventAlt)" {string}, shows alternate-events in red
'{"hover":{"fillColor":"black","tfi":{"fgColor":"white"}}}(event)' {string}, shows the event in white on a black-background, while the cursor hovers it
"xxx(d),yyy(d,m),zzz(y)" {string}, specifies that the exontrol.Shapes.Schedule.xxx combined with exontrol.Shapes.Schedule.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.Schedule.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.Schedule.zzz object defines the visual appearance of "y" part of the control
shapes
(static) shortDateFormat :string
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, "<%loc_sdate%>"
"" {string}, nothing is displayed
"<%loc_sdate%>" {string}, displays the date in the short format using the current user regional and language settings
"<%mm%>/<%dd%>/<%yyyy%>" {string}, displays the date in mm/dd/yyyy format
shortDateFormat
(static) shortTimeFormat :string
- <%d%> - Day of the month in one or two numeric digits, as needed (1 to 31)
- <%dd%> - Day of the month in two numeric digits (01 to 31)
- <%d1%> - First letter of the weekday (S to S)
- <%loc_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings
- <%d2%> - First two letters of the weekday (Su to Sa)
- <%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings
- <%d3%> - First three letters of the weekday (Sun to Sat)
- <%loc_d3%> equivalent with <%loc_ddd%>
- <%ddd%> - First three letters of the weekday (Sun to Sat)
- <%loc_ddd%> - Indicates the day of week as a three-letter abbreviation using the current user regional and language settings
- <%dddd%> - Full name of the weekday (Sunday to Saturday)
- <%loc_dddd%> - Indicates day of week as its full name using the current user regional and language settings
- <%i%> - Displays the number instead the date
- <%w%> - Day of the week (1 to 7)
- <%ww%> - Week of the year (1 to 53)
- <%m%> - Month of the year in one or two numeric digits, as needed (1 to 12)
- <%mr%> - Month of the year in Roman numerals, as needed (I to XII)
- <%mm%> - Month of the year in two numeric digits (01 to 12)
- <%m1%> - First letter of the month (J to D)
- <%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings
- <%m2%> - First two letters of the month (Ja to De)
- <%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings
- <%m3%> - First three letters of the month (Jan to Dec)
- <%loc_m3%> - equivalent with <%loc_mmm%>
- <%mmm%> - First three letters of the month (Jan to Dec)
- <%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user regional and language settings
- <%mmmm%> - Full name of the month (January to December)
- <%loc_mmmm%> - Indicates month as its full name using the current user regional and language settings
- <%q%> - Date displayed as the quarter of the year (1 to 4)
- <%y%> - Number of the day of the year (1 to 366)
- <%yy%> - Last two digits of the year (01 to 99)
- <%yyyy%> - Full year (0100 to 9999)
- <%hy%> - Date displayed as the half of the year (1 to 2)
- <%loc_g%> - Indicates period/era using the current user regional and language settings
- <%loc_gg%> - Indicates period/era using the current user regional and language settings
- <%loc_sdate%> - Indicates the date in the short format using the current user regional and language settings
- <%loc_ldate%> - Indicates the date in the long format using the current user regional and language settings
- <%loc_dsep%> - Indicates the date separator using the current user regional and language settings (/)
- <%h%> - Hour in one or two digits, as needed (0 to 23)
- <%hh%> - Hour in two digits (00 to 23)
- <%h12%> - Hour in 12-hour time format, in one or two digits - [0(12),11]
- <%hh12%> - Hour in 12-hour time format, in two digits - [00(12),11]
- <%n%> - Minute in one or two digits, as needed (0 to 59)
- <%nn%> - Minute in two digits (00 to 59)
- <%s%> - Second in one or two digits, as needed (0 to 59)
- <%ss%> - Second in two digits (00 to 59)
- <%AM/PM%> - Twelve-hour clock with the uppercase letters "AM" or "PM", as appropriate
- <%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user regional and language settings
- <%loc_A/P%> - Indicates the one character time marker such as A or P using the current user regional and language settings
- <%loc_time%> - Indicates the time using the current user regional and language settings
- <%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user regional and language settings
- <%loc_tsep%> - indicates the time separator using the current user regional and language settings (:)
- <%loc_y%> - Represents the Year only by the last digit, using current regional settings
- <%loc_yy%> - Represents the Year only by the last two digits, using current regional settings. A leading zero is added for single-digit years
- <%loc_yyyy%> - Represents the Year by a full four or five digits, depending on the calendar used. Thai Buddhist and Korean calendars have five-digit years. The "yyyy" pattern shows five digits for these two calendars, and four digits for all other supported calendars. Calendars that have single-digit or two-digit years, such as for the Japanese Emperor era, are represented differently. A single-digit year is represented with a leading zero, for example, "03". A two-digit year is represented with two digits, for example, "13". No additional leading zeros are displayed
Type:
- string
Example
null {null}, "<%h%>:<%nn%> <%AM/PM%>"
"" {string}, nothing is displayed
"<%loc_time%>" {string}, Indicates the time using the current user regional and language settings
"<%hh%>:<%nn%>" {string}, displays the time in hh:nn format
shortTimeFormat
(static) showAllDayHeader :boolean
Type:
- boolean
Example
false{boolean} or null {null}, hides the all-day header
true{boolean}, shows the all-day header
showAllDayHeader
(static) showEventLabels :boolean
Type:
- boolean
Example
false {boolean}, the event's short, long or extra labels are not shown
true {boolean}, the event's short, long or extra labels are visible
showEventLabels
(static) showEvents :number
- -1 (exShowAllEvents) {number}, shows all events
- 0 (exHideEvents) {number}, the control displays no events
- 1 (exShowRegularEvents) {number}, the control displays regular events
- 2 (exShowRepetitiveEvents) {number}, the control displays repetitive events (The Repetitive property indicates the expression that defines the dates where the event occurs)
Type:
- number
Example
-1 {number} or null {null}, the control displayes all events (equivalent of exShowAllEvents)
0 {number}, hides the events
1 {number}, shows only the regular events (non-repetitive events)
3 {number}, shows regular and repetitive events, where 3 is 1 (exShowRegularEvents) | 2 (exShowRepetitiveEvents)
showEvents
(static) showGroupingEvents :boolean
The control displays groups if:
- showGroupingEvents option is true
- The Groups collection has visible elements. By default, the Groups collection contains no Group objects
Type:
- boolean
Example
false {boolean}, no grouped events are shown
true {boolean}, shows the events grouped
showGroupingEvents
(static) showHighlightEvent :boolean
Type:
- boolean
Example
false {boolean}, no date is highlighted
true {boolean}, the date with events is highlighted using the "uiHighlight"/"calendar-uiHighlight" shape
showHighlightEvent
(static) showMarkZone :number
- 0 (exHideMarkZones) {number}, no mark-zone is displayed
- 1 (exShowMarkZonesBack) {number}, the mark-zone(s) are displayed on the background (behind events)
- 2 (exShowMarkZonesFront) {number}, the mark-zone(s) are displayed on the foreground
Type:
- number
Example
null {null}, the mark-zones are displayed on front
0 {number}, hides the mark-zones
1 {number}, shows the mark-zones on the background (behind events)
showMarkZone
(static) showViewCompact :exontrol.Schedule.ShowViewCompactEnum
- exViewCalendar(0), specifies that the schedule view arranges the days as they are shown in the calendar panel.
- exViewCalendarCompact(-1), the schedule view arranges the days as they are shown in the calendar panel, excepts that the first day of the month starts right after the last day of the previously month, or start to a new row.
- exViewSingleRow(1), the schedule view arranges all days to a single row (horizontally)
- exViewSingleColumn(2), the schedule view arranges all days to a single column (vertically)
- exViewSingleRowLockHeader(3), the schedule view arranges all days to a single row (horizontally), while the date header is shown/locked on the top while the chart is vertically scrolled
Type:
- exontrol.Schedule.ShowViewCompactEnum
Example
-1 or exontrol.Schedule.ShowViewCompactEnum.exViewCalendarCompact {number}, the schedule view arranges the days as they are shown in the calendar panel, excepts that the first day of the month starts right after the last day of the previously month, or start to a new row.
3 or exontrol.Schedule.ShowViewCompactEnum.exViewSingleRowLockHeader {number}, the schedule view arranges all days to a single row (horizontally), while the date header is shown/locked on the top while the chart is vertically scrolled.
showViewCompact
(static) singleSel :Schedule.SingleSelEnum
- exDisableSel(0), specifies that the control's selection is disabled (can not be combined with any other flags)
- exEnableSel(1), specifies that the control's selection is enabled (multiple-selection, unless the exSingleSel is set )
- exSingleSel(2), specifies that the user can select a event only
- exToggleSel(4), specifies that the event's selection state is toggled once the user clicks a event.
- exDisableCtrlSel(8), disables toggling the event's selection state when user clicks a event, while CTRL modifier key is pressed.
- exDisableShiftSel(16), disables selecting events using the SHIFT key.
- exDisableDrag(32), disables selecting events by drag.
Type:
Example
0 or exontrol.Schedule.SingleSelEnum.exDisableSel {number}, disables selecting any event
3 or exontrol.Schedule.SingleSelEnum.exSingleSel | exontrol.Schedule.SingleSelEnum.exEnableSel {number}, enables control's single selection, so only a single event can be selected
6 or exontrol.Schedule.SingleSelEnum.exToggleSel | exontrol.Schedule.SingleSelEnum.exSingleSel {number}, enables control's single and toggle selection, which means that once a event is selected it gets unselected once it is clicked, or reverse, and only a single-event can be selected at once.
singleSel
(static) smooth :number
Type:
- number
Example
0 {number}, no smooth changes once the control goes from a layout to another
125 {number}, specifies that a smooth-transition is performed from a layout to another for 125 ms.
smooth
(static) tfi :string|object
The tfi field as string supports any of the following keywords (each keyword can be specified using first letters only such as "b" for "bold) separated by space characters:
- bold, displays the text in bold (equivalent of <b> tag)
- italic, displays the text in italics (equivalent of <i> tag)
- underline, underlines the text (equivalent of <u> tag)
- strikeout, specifies whether the text is strike-through (equivalent of <s> tag)
- <fontName name>, specifies the font's family (equivalent of <font name> tag)
- <fontSize size>, specifies the size of the font (equivalent of <font ;size> tag)
- <fgColor CSSColor>, specifies the text's foreground color (equivalent of <fgcolor> tag)
- <bgColor CSSColor>, specifies the text's background color (equivalent of <bgcolor> tag)
- <shaColor CSSColor;width;offset>, defines the text's shadow (equivalent of <sha color;width;offset> tag)
- <outColor CSSColor>, shows the text with outlined characters (CSScolor) (equivalent of <out color> tag)
- <graColor CSSColor;mode;blend>, defines a gradient text (equivalent of <gra color;mode;blend> tag)
Any other word within the tfi field that's not recognized as a keyword is interpreted as:
- name of the font (not a number), specifies the font's family (equivalent of <font name> tag)
- size of the font (number), specifies the size of the font (equivalent of <font ;size> tag)
The tfi field as object supports any of the following fields:
- bold {boolean}, displays the text in bold (equivalent of <b> tag)
- italic {boolean}, displays the text in italics (equivalent of <i> tag)
- underline {boolean}, underlines the text (equivalent of <u> tag)
- strikeout {boolean}, specifies whether the text is strike-through (equivalent of <s> tag)
- fontName {string}, specifies the font's family (equivalent of <font name> tag)
- fontSize {number}, specifies the size of the font (equivalent of <font ;size> tag)
- fgColor {string}, specifies the text's foreground color (CSScolor) (equivalent of <fgcolor> tag)
- bgColor {string}, specifies the text's background color (CSScolor) (equivalent of <bgcolor> tag)
- shaColor {object}, specifies an object of {color, width, offset} type that defines the text's shadow (equivalent of <sha color;width;offset> tag), where:
- color {string}, defines the color of the text's shadow (CSScolor)
- width {number}, defines the size of the text's shadow
- offset {number}, defines the offset to show the text's shadow relative to the text
- outColor {string}, shows the text with outlined characters (CSScolor) (equivalent of <out color> tag)
- graColor {object}, specifies an object of {color, mode, blend} type that defines a gradient text (equivalent of <gra color;mode;blend> tag), where:
- color {string}, defines the gradient-color (CSScolor)
- mode {number}, defines the gradient mode as a value between 0 and 4
- blend {number}, defines the gradient blend as a value between 0 and 1
CSSColor or CSS legal color values can be specified by the following methods:
- Hexadecimal colors, is specified with: #RRGGBB, where the RR (red), GG (green) and BB (blue) hexadecimal integers specify the components of the color. All values must be between 00 and FF. For example, #0000ff value is rendered as blue, because the blue component is set to its highest value (ff) and the others are set to 00.
- Hexadecimal colors with transparency, is specified with: #RRGGBBAA, where AA (alpha) value must be between 00 and FF. For example, #0000ff80 defines a semi-transparent blue.
- RGB colors, is specified with the RGB(red, green, blue) function. Each parameter (red, green, and blue) defines the intensity of the color and can be an integer between 0 and 255. For example, rgb(0,0,255) defines the blue color.
- RGBA colors, are an extension of RGB color values with an alpha channel as RGBA(red, green, blue, alpha) function, where the alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque). For example, rgba(0,0,255,0.5) defines a semi-transparent blue.
- HSL colors, is specified with the HSL(hue, saturation, lightness) function, where hue is a degree on the color wheel (from 0 to 360) - 0 (or 360) is red, 120 is green, 240 is blue. saturation is a percentage value; 0% means a shade of gray and 100% is the full color. lightness is also a percentage; 0% is black, 100% is white. HSL stands for hue, saturation, and lightness - and represents a cylindrical-coordinate representation of colors. For example, hsl(240, 100%, 50%) defines the blue color.
- HSLA colors, are an extension of HSL color values with an alpha channel - which specifies the opacity of the object as HSLA(hue, saturation, lightness, alpha) function, where alpha parameter is a number between 0.0 (fully transparent) and 1.0 (fully opaque). For example, hsla(240, 100%, 50%,0.5) defines a semi-transparent blue.
- Predefined/Cross-browser color names, 140 color names are predefined in the HTML and CSS color specification. For example, blue defines the blue color.
Type:
- string | object
Example
null {null}, the tfi field is ignored
"bold monospace 16 <fg blue>" {string}, defines Monospace font of 16px height, bold and blue
{bold: true, fontName: "monospace", fontSize: 16, fgColor: "blue"} {object}, defines Monospace font of 16px height, bold and blue
tfi
(static) timeScale :TimeScaleOptions
Type:
(static) toolTipDelay :number
Type:
- number
Example
0 {number}, the tooltip is shown "immediately"
128 {number}, the tooltip is displayed in 128 ms.
toolTipDelay
(static) toolTipPopDelay :number
Type:
- number
Example
0 {number}, no tooltip is shown for any object (disabled)
-1 {number}, the tooltip stays indefinitely (negative)
1000 {number}, the tooltip is visible for 1 second
toolTipPopDelay
(static) toolTipWidth :number
Type:
- number
Example
0 {number}, no tooltip is shown for any object (disabled)
-1 {number}, the tooltip's content is displayed on a single line (without limit the width of it)
300 {number}, the tooltip's max-width is 300 pixels
toolTipWidth
(static) undoRedoQueueLength :number
- negative {number}, no limit for the control's Undo/Redo queue
- 0 {number}, the control's Undo/Redo feature is disabled
- positive {number}, specifies the maximum number of Undo/Redo actions that may be stored to the control's Undo/Redo queue
Type:
- number
- Since:
- 2.0
Example
-1 {number}, the Undo/Redo queue is limitless
1 {number}, the Undo/Redo queue limits the number of actions to store to 1 (one action or one block of actions)
undoRedoQueueLength
(static) updateEventsLabel :string
- %1 (exEventStartDateTime) {Date}, indicates the starting date/time of the event. This property gets the Start property of the event. The Start property defines the lower margin of the event, and it includes the date and the time values. The exEventStartDate specifies the DATE value only, while the exEventStartTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%1)%>" displays the day of the week where the event starts
- %2 (exEventEndDateTime) {Date}, indicates the ending date/time of the event. This property gets or sets the End property of the event. The End property defines the upper margin of the event, and it includes the date and the time values. The exEventEndDate specifies the DATE value only, while the exEventEndTime includes the TIME value only. For instance, the LabelProperty = "<%=weekday(%2)%>" gets the day of the week where the event ends.
- %3 (exEventAllDay) {boolean}, indicates if the current event is an all day event. This property is equivalent with the event's AllDay property which indicates if the current event is an all-day event. For instance, the LabelProperty = "<%=%3 ? `All-Day-Event: `: ``%><%=%256%>", displays automatically an "All-Day-Event: " prefix for all-day events. If the event is not an all-day event, the <%=%256%>, or exEventDisplayShortMargins, short margins of the events are displayed.
- %4 (exEventGroupID) {any}, specifies the identifier/index of the event's group. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupLabel property indicates the Caption property of the Group's event. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%4%>
<%=%256%>" displays on the first line, the group's identifier, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %5 (exEventCaption) {string}, indicates the caption of the event. The Caption property of the event specifies the custom caption that can be displayed on the label, without having to change the event's label. For instance, the LabelProperty = "<%=%256%>
<%=%5%>" displays on the first line, the event's short margins, while on the second line displays the event's caption. Once you update or edit the event's Caption, the event's body automatically shows the new caption. - %6 (exEventUserData) {any}, indicates the extra data associated with the event. The UserData property of the event indicates an extra data associated with the event. For instance, the LabelProperty = "<%=%256%>
<%=%6%>" displays on the first line, the event's short margins, while on the second line displays the event's user data. Once you update or edit the event's UserData, the event's body automatically shows the new label. - %7 (exEventDuration) {number}, specifies the duration of the event. The returned values is of float type, and it indicates the duration of the event in days. For instance, the 1.5 indicates, 1 day and 12 hours. For instance, the LabelProperty = "<%=%256%>
<%=((1:=int(0:= (date(%2)-date(%1)))) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" displays on the first line, the event's short margins, while on the second line displays the event's durations in days, hours and minutes. Once you update or edit the event's margins, the event's body automatically shows the new length. You can use the MoveBy method to delay the current event with a specified value time. You can use the SetKnownProperty(exEventDuration) to change the event's duration. - %8 (exEventRepetitiveExpression) {string}, specifies the repetitive expression of the event. The Repetitive property of the event indicates the expression that determines whether the event is repetitive. For instance, the LabelProperty = "<%=%256%>
<%=len(%8)? `repetitive event`:``%>" displays repetitive event for repetitive events. - %12 (exEventID) {string}, specifies the event's unique key/identifier/index.
- %256 (exEventDisplayShortMargins) {string}, displays the margins of the event in a short format (read-only). The ShortDateFormat property defines the short date format. The ShortTimeFormat property defines the short time format.
- %257 (exEventDisplayLongMargins) {string}, displays the margins of the event in a long format (read-only). The LongDateFormat property defines the long date format. The LongTimeFormat property defines the long time format.
- %258 (exEventStartDate) {Date}, gets the starting date ( not including the time ) of the event (read-only). You can use this property to get the starting date of the event.
- %259 (exEventStartTime) {number}, gets the starting time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the starting time of the event.
- %260 (exEventEndDate) {Date}, gets the ending date ( not including the time ) of the event (read-only). You can use this property to get the ending date of the event.
- %261 (exEventEndTime) {number}, gets the ending time ( not including the date ) of the event, as a number between 0 and 1 (read-only). You can use this property to get the ending time of the event.
- %262 (exEventGroupLabel) {string}, gets the label of the owner group (read-only). The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. The exEventGroupTitle property indicates the Title property of the Group's event. For instance, the LabelProperty = "<%=%262%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %263 (exEventGroupTitle) {string}, gets the title of the owner group (read-only). The exEventGroupTitle property indicates the Title property of the Group's event. The exEventGroupLabel property indicates the Caption property of the Group's event. The GroupID property of the event indicates the identifier of the group that event belongs to. For instance, the LabelProperty = "<%=%263%>
<%=%256%>" displays on the first line, the group's caption, and the short margins of the event on the second line. The caption of the label is automatically updated once an event is moved from a group to another. - %264 (exEventRepetitive) {boolean}, Indicates if the current event is a repetitive event. (read-only). You can use this flag to specify whether Repetitive property is not empty, and valid.
Type:
- string
Example
null {null}, the control's DefaultEventLongLabel/DefaultEventShortLabel property defines the event's label while the user moves or resizes the events by drag and drop
"" {string}, no label is shown for the event to resize or move
"Start: <%=%1%><br>End: <%=%2%>" {string}, displays the starting margin of the even on the first line, while on the second line it displays the ending point of the event
"Duration: <%=((1:=int(0:= %7)) != 0 ? (=:1 + ' day(s)') : '') + (=:1 ? ' ' : '' ) + ((1:=int(0:=((=:0 - =:1 + 1/24/60/60/2)*24))) != 0 ? =:1 + ' hour(s)' : '' ) + (=:1 ? ' ' : '' ) + ((1:=round((=:0 - =:1)*60)) != 0 ? =:1 + ' min(s)' : '')%>" {string}, displays the duration of the event in days, hours and minutes
updateEventsLabel
(static) wheelChange :number
Type:
- number
Example
0 {number}, locks any action the mouse's wheel performs
18 {number}, scrolls the control by 18-pixels when mouse's wheel is rotated (CTRL + wheel scrolls horizontally)
wheelChange
(static) zoom :number
Type:
- number
Example
null {null}, Specifies normal-view (100%)
150 {number}, Indicates that the control's content is magnfied to 150%
zoom
(static) zoomLevels :string
Type:
- string
Example
null {null}, Specifies that the control's zoom factor is always 100%
150 {number}, Specifies that the control's zoom factor is always 150%
"50,100,200,350" {string}, Indicates that the zoom-factor can be any of selected values, and the levels of zoom-factor is 50% to 350%
zoomLevels