/**
 * @description The exontrol.helpTFI namespace provides documentation for exontrol.TFI object, which holds font attributes to displays a text or a portion of text
*/
exontrol.helpTFI =
{
  /**
  * @description The tfi field applies font attributes to 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}.
  *
  * 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" {string}, defines Monospace font of 16px height, bold
  *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
  */
  tfi:
  {
    /**
     * @description The bold field specifies whether characters in text should be displayed in bold (equivalent of <b> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is displayed in bold
     *  false {boolean}, displays normal text
    */
     bold: false,
    /**
     * @description The italic field specifies whether characters in text should be displayed in italics (equivalent of <i> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is displayed in italics
     *  false {boolean}, displays normal text
    */
     italic: false,
    /**
     * @description The underline field specifies whether characters in text are underlined (equivalent of <u> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is underlined
     *  false {boolean}, displays normal text
    */
     underline: false,
    /**
     * @description The strikeout field specifies whether characters in text are strike-through (equivalent of <s> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that characters in text are strike-through
     *  false {boolean}, displays normal text
    */
     strikeout: false,
    /**
     * @description The fgcolor field specifies the text's foreground color (equivalent of <fgcolor color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the fgcolor field is ignored
     *  "red" {string}, displays the text in red color
     *  "rgb(255,0,0)" {string}, displays the text in red color
     *  "rgba(255,0,0,0.5)" {string}, displays the text in semi-transparent red color
    */
     fgColor: null,
    /**
     * @description The bgcolor field specifies the text's background color (equivalent of <bgcolor color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the bgcolor field is ignored
     *  "red" {string}, displays the text's background in red color
     *  "rgb(255,0,0)" {string}, displays the text's background in red color
     *  "rgba(255,0,0,0.5)" {string}, displays the text's background in semi-transparent red color
    */
     bgColor: null,
    /**
     * @description The fontSize field defines the size to display the font (equivalent of <font family;size> tag of ex-HTML captions).
     * @type {number}
     * @example
     *
     *  null {null}, specifies that the fontSize field is ignored
     *  12 {number}, defines the size of the font to 12 pixels
    */
     fontSize: null,
    /**
     * @description The fontName field defines family of the font to show the text (equivalent of <font family;size> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the fontName field is ignored
     *  "Georgia" {string}, indicates Georgia font family
    */
     fontName: null,
    /**
     * @description The shacolor field defines the text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
     * @type {object}
    */
    shaColor:
    {
      /**
       * @description The color field specifies the color for text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {string}
       * @example
       *
       *  null {null}, specifies that the color field is ignored
       *  "red" {string}, defines red shadow for text
       *  "rgb(255,0,0)" {string}, defines red shadow for text
       *  "rgba(255,0,0,0.5)" {string}, defines semi-transparent red shadow for text
      */
       color: null,
      /**
       * @description The width field defines the size of text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {number}
       * @example
       *
       *  null {null}, specifies that the width field is ignored
       *  4 {number}, indicates a 4-pixels wide for text's shadow
      */
       width: null,
      /**
       * @description The offset field defines the offset of text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {number}
       * @example
       *
       *  null {null}, specifies that the offset field is ignored
       *  4 {number}, shows the text's shadow with a different offset
      */
       offset: null
    },
    /**
     * @description The outcolor field defines color to show outlined text (equivalent of <out color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the outcolor field is ignored
     *  "red" {string}, defines a red-outlined text
     *  "rgb(255,0,0)" {string}, defines a red-outlined text
     *  "rgba(255,0,0,0.5)" {string}, defines a semi-tranparent red-outlined text
    */
     outColor: null,
    /**
     * @description The gracolor field specifies whether the text is show in gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions).
     * @type {object}
    */
    graColor:
    {
      /**
       * @description The color field specifies the color for text's gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions).
       * @type {string}
       * @example
       *
       *  null {null}, specifies that the color field is ignored
       *  "red" {string}, defines a red-gradient text
       *  "rgb(255,0,0)" {string}, defines a red-gradient text
       *  "rgba(255,0,0,0.5)" {string}, defines a semi-tranparent red-gradient text
      */
       color: null,
      /**
       * @description The mode field defines mode of the text's gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions). The mode is a value between 0 and 3, 1 if missing/null or undefined.
       * @type {number}
       * @example
       *
       *  0 {number}, defines the gradient from left to right
       *  1 {number}, defines the gradient from right to left
       *  2 {number}, defines the gradient from top to bottom
       *  3 {number}, defines the gradient from bottom to top
       *
      */
       mode: null,
      /**
       * @description The blend field defines gradient's blend value (equivalent of <gra color;mode;blend> tag of ex-HTML captions). Could be 0 or 1. Currently, the gradient's blend is not available
       * @type {number}
      */
       blend: null
    }
  }
}

/**
 * @description The exontrol.helpShape namespace provides documentation for exontrol.S objects.
*/
exontrol.helpShape =
{
  /**
  * @description The shape field includes definitions to draw shapes. An object of exontrol.Def.Shape type.
  * @type {object}
  */
  shape:
  {
    /**
     * @description The opacity field sets the opacity level of the object. It is a number between 0.0 (fully transparent) and 1.0 (fully opaque).
     * @type {number}
     * @example
     *
     *  null {null}, the opacity field is ignored
     *  0 {number}, completely transparent
     *  0.5 {number}, semi-transparent
     *  1 {number}, fully-opaque
    */
     opacity: null,
    /**
     * @description The client field specifies a collection of up to four expressions that can define a different client area to show the object (see also padding). A string expression of "[expression,expression,expression,expression]" type, that determines the x, y, width and height of the new client. The client field must starts with "[" and ends with "]", else it has no effect.
     *
     * Each expression supports the following keywords:
     *
     *   x {number}, defines the object's default-left position
     *   y {number}, defines the object's default-top position
     *   width {number}, indicates the default-width of the object
     *   height {number}, indicates the default-width of the object.
     *
     * @type {string}
     * @example
     *
     *   null {null}, the client field is ignored
     *   "[x+64,y-32]" {string}, displays the object at a different position (offset by 64-pixels on x-axis, and 32-pixels up on y-axis)
     *   "[x-8,y-4,width+2*8,height+2*4]" {string}, is equivalent of padding on [8,4]
     *   "[x+(width-16)/2,y+(height-16)/2,16,16]" {string}, centers a 16x16 rectangle inside the client
    */
     client: null,
    /**
     * @description The padding field defines how much the object's client area is increased or decreased (see also client)
     * @type {(number|string|array)}
     * @example
     *
     *   null {null}, indicates that the padding field is ignored
     *   4 {number}, increases the object's client with 2 * 4-pixels, which includes width and height
     *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
     *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
    */
     pad: null,
    /**
    * @description The fillColor field defines the color to show the object's background.
    * @type {string}
    * @example
    *
    *  null {null}, specifies that the fillColor field is ignored
    *  "transparent" {string}, fills the object's background with rgba(0,0,0,0)/transparent color
    *  "red" {string}, fills the object's background with red color
    *  "rgb(255,0,0)" {string}, fills the object's background with red color
    *  "rgba(255,0,0,0.5)" {string}, fills the object's background with semi-tranparent red color
    */
     fillColor: null,
    /**
    * @description The fillGradientColor field defines the gradient type and colors to show the object's background.
    * @type {string}
    *
    * The fillColor field defines the starting color. The fillGradientColor field has effect only if the fillColor field is defined (not null or undefined).
    *
    * The first field of the fillGradientColor field could start with any of the following:
    *
    *   "vertical", defines a vertical-gradient (default)
    *   "horizontal", defines a horizontal-gradient
    *   "diagonal", defines a diagonal-gradient
    *   "radial", defines a radial-gradient
    *
    * The next fields indicates the stop-colors.
    *
    * @example
    *
    *  null {null}, specifies that the fillGradientColor field is ignored, so no gradient is applied on the object's background.
    *  "black" {string}, specifies a vertical-gradient that starts from fillColor and ends on black.
    *  "horizontal,red,green,blue" {string}, specifies a horizontal-gradient that starts from fillColor, continues with red, green and ends on blue.
    *  "diagonal,red,rgba(0,255,0,0.5),blue" {string}, specifies a diagonal-gradient that starts from fillColor, continues with red, 50% green and ends on blue.
    *  "radial,black" {string}, specifies a radial/circular-gradient that starts from fillColor and ends on black.
    */
     fillGradientColor: null,
    /**
     * @description The clientText field specifies a collection of up to four expressions that defines the new client area to display the shape's text (equivalent of offset, pad), relative to the shape's client area. A string expression of "[expression,expression,expression,expression]" type, that determines the x, y, width and height of the new client text. The clientText field must starts with "[" and ends with "]", else it has no effect.
     *
     * Each expression supports the following keywords:
     *
     *   x {number}, defines the object's default-left position
     *   y {number}, defines the object's default-top position
     *   width {number}, indicates the default-width of the object
     *   height {number}, indicates the default-width of the object.
     *
     * @type {string}
     * @example
     *
     *   null {null}, the clientText field is ignored
     *   "[x+64,y-32]" {string}, displays the text at a different position (offset by 64-pixels on x-axis, and 32-pixels up on y-axis)
     *   "[x-8,y-4,width+2*8,height+2*4]" {string}, is equivalent of padding on [8,4]
     *   "[,,width-20]" {string}, narrows the text's client with 20 pixels on right
    */
     clientText: null,
    /**
    * @description The padText field defines the padding to display the object's caption (see also text).
    * @type {number}
    * @example
    *
    *   null {null}, indicates that the padText field is ignored
    *   4 {number}, increases the caption's client with 2 * 4-pixels, which includes width and height
    *   "8,4" {string}, increases the caption's width with 2 * 8-pixels and caption's height with 2 * 4-pixels
    *   [8,4] {array}, increases the caption's width with 2 * 8-pixels and caption's height with 2 * 4-pixels
    */
     padText: null,
    /**
    * @description The text field defines the caption to be displayed on the object. The caption/text supports ex-HTML tags as listed bellow:
    *
    *   "<b>text</b>", displays the text in bold.
    *   "<i>text</i>", displays the text in italics.
    *   "<u>text</u>", underlines the text.
    *   "<s>text</s>", strike-through text
    *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
    *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
    *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
    *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
    *   "<br>", defines a forced line-break
    *   "<r>", right aligns the text
    *   "<c>", centers the text
    *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
    *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
    *   "<off offset>text</off>", defines the vertical offset to display the text.
    *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
    *   "<out color[;width]>text</out>", shows the text with outlined characters
    *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
    *
    * @type {string}
    * @example
    *
    *   null {null}, ignores the text field
    *   "this is a <fgcolor red>test</fgcolor>" {string}, where "test" is displayed in red color
    *   "this is a <b><off 4>test</off></b> of ex-HTML caption" {string}, where "test" is displayed in bold with a different vertical-offset
    */
     text: null,
    /**
    * @description The formatText field specifies the format to display the object's caption.
    *
    * The exontrol.DrawTextFormatEnum type support the following flags:
    *
    *   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 <fgcolor> and </bgcolor> 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}, defines a single-line centered text (equivalent of exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextWordEllipsis )
    *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line text
    *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line text right/bottom-aligned
    */
     formatText: null,
    /**
    * @description The tfi field applies font attributes to 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}.
    *
    * 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" {string}, defines Monospace font of 16px height, bold
    *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
    */
     tfi: null,
    /**
    * @description The clipText field indicates whether the caption is clipped to object.
    * @type {boolean}
    * @example
    *
    *   false {boolean}, the text/caption is not cliped
    *   true {boolean}, the text/caption is cliped to the object's client-rectangle
    */
     clipText: false,
    /**
    * @description The frameColor field defines the color to show the object's frame (see also primitive).
    * @type {string}
    * @example
    *
    *  null {null}, specifies no frame
    *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent frame
    *  "red" {string}, defines a red-frame
    *  "rgb(255,0,0)" {string}, defines a red-frame
    *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-frame
    */
     frameColor: null,
    /**
    * @description The frameSize field defines size of the object's frame.
    * @type {number}
    * @example
    *
    *  null {null}, draws the frame, only if the frameColor is defined
    *  0 {number}, shows no frame
    *  4 {number}, defines a 4-pixels frame
    */
     frameSize: null,
    /**
    * @description The frameDash field defines style of the object's frame. An Array of numbers which specify distances to alternately draw a line and a gap (in coordinate space units). If the number of elements in the array is odd, the elements of the array get copied and concatenated.
    * @type {array}
    * @example
    *
    *  null {null}, defines a solid frame
    *  [] {array}, indicates a solid frame
    *  2 {number}, will become [2, 2, ...]
    *  [5, 15, 25] {array}, will become [5, 15, 25, 5, 15, 25, ...]
    */
     frameDash: null,
    /**
    * @description The frameJoin field determines how two connecting segments into the object's frame are joined together. There are three possible values for this property as follows:
    *
    *  "round", rounds off the corners of a object by filling an additional sector of disc centered at the common endpoint of connected segments. The radius for these rounded corners is equal to the line width.
    *  "bevel", fills an additional triangular area between the common endpoint of connected segments, and the separate outside rectangular corners of each segment.
    *  "miter", connected segments are joined by extending their outside edges to connect at a single point, with the effect of filling an additional lozenge-shaped area.
    *
    * @type {string}
    * @example
    *
    *  null {null}, defines a "miter" join
    *  "round" {string}, rounds off the corners of a object by filling an additional sector of disc centered at the common endpoint of connected segments.
    */
     frameJoin: null,
    /**
    * @description The frameCap field determines how the end points of every line into the object's frame are drawn. There are three possible values for this property as follows:
    *
    *  "butt", the ends of lines are squared off at the endpoints.
    *  "round", the ends of lines are rounded
    *  "square", the ends of lines are squared off by adding a box with an equal width and half the height of the line's thickness.
    *
    * @type {string}
    * @example
    *
    *  null {null}, indicates "but" style
    *  "round" {string}, the ends of lines are rounded
    */
     frameCap: null,
    /**
    * @description The pattern field defines the pattern to show on the object's background (see also patternColor).
    *
    * The exontrol.PatternEnum type defines the following values:
    *
    *   exPatternEmpty (0), defines no pattern
    *   exPatternSolid (1), defines a solid-pattern
    *   exPatternDot (2), defines a dot-pattern
    *   exPatternShadow (3), defines a shadow-pattern
    *   exPatternNDot (4), defines a not-dot-pattern
    *   exPatternFDiagonal (5), defines a forward-diagonal-pattern
    *   exPatternBDiagonal (6), defines a backward-diagonal-pattern
    *   exPatternDiagCross (7), defines a cross-diagonal-pattern
    *   exPatternVertical (8), defines a vertical-pattern
    *   exPatternHorizontal (9), defines a horizontal-pattern
    *   exPatternCross (10), defines a cross-pattern
    *   exPatternBrick (11), defines a brick-pattern
    *   exPatternYard (12), defines a yard-pattern
    *
    * @type {exontrol.PatternEnum}
    * @example
    *
    *  null {null}, defines no pattern
    *  0 or exontrol.PatternEnum.exPatternEmpty {number}, defines an empty pattern (no pattern)
    *  7 or exontrol.PatternEnum.exPatternDiagCross {number}, defines a cross-diagonal-pattern
    */
     pattern: null,
    /**
    * @description The patternColor field defines the color to show the object's pattern (see also pattern).
    * @type {string}
    * @example
    *
    *  null {null}, indicates a black-color
    *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent pattern
    *  "red" {string}, defines a red-pattern
    *  "rgb(255,0,0)" {string}, defines a red-pattern
    *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-pattern
    */
     patternColor: null,
    /**
     * @description The shadow field holds information about box's shadow.
     * @type {object}
     */
    shadow:
    {
      /**
      * @description The color field defines the shadow's color. Defines the shadow's color in CSS format. The color, x or y properties have no effect while blur property is not defined.
      * @type {string}
      * @example
      *
      *  null {null}, indicates that the frameColor or fillColor property determines the shadow's color
      *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent shadow
      *  "red" {string}, defines a red-shadow
      *  "rgb(255,0,0)" {string}, defines a red-shadow
      *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-shadow
      */
       color: null,
      /**
      * @description The blur field defines the blur level for shadows.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates no shadow
      *  4 {number}, defines shadow's blur to 4
      */
       blur: 0,
      /**
      * @description The x field defines the horizontal distance of the shadow from the object. Defines horizontal distance of the shadow from the object. The color, x or y properties have no effect while blur property is not defined.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates the shadow's x-offset at 0
      *  -4 {number}, defines shadow's x-offset to -4
      *  4 {number}, defines shadow's x-offset to 4
      */
       x: 0,
      /**
      * @description The y field defines vertical distance of the shadow from the object. By default, it is 0.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates the shadow's y-offset at 0
      *  -4 {number}, defines shadow's y-offset to -4
      *  4 {number}, defines shadow's y-offset to 4
      */
       y: 0
    },
    /**
    * @description The primitive field defines the type of frame the object is displaying (see also pArg)
    *
    *  The primitive could be any of the following predefined values:
    *
    *    "Rect" {string}, defines a rectangular-object
    *    "RoundRect" {string}, defines a round rectangular-object. The pArg.x, pArg.y define the radius of round-corners.
    *    "BevelRect" {string}, defines a bevel rectangular-object. The pArg.x, pArg.y define the radius of round-corners.
    *    "Ellipse" {string}, defines an elliptic-object
    *    "Pie" {string}, defines a pie-object. The pArg.startAngle property defines the angle (radians) the pie starts from. The pArg.sweepAngle property defines the length (radians) of the pie.
    *    "Arc" {string}, defines an arc-object. The pArg.startAngle property defines the angle (radians) the arc starts from. The pArg.sweepAngle property defines the length (radians) of the arc.
    *    "Oval" {string}, defines an oval-object.
    *    "Circle" {string}, defines a circle-object.
    *    "Triangle" {string}, defines a triangle-object.
    *    "EllipticPolygon" {string}, defines an elliptic-polygon-object. The pArg.edges property defines the number of edges within the elliptic-polygon. The pArg.startAngle property defines the angle (radians) the elliptic-polygon starts from.
    *    "Polygon" {string}, defines a polygon-object. The pArg.points property defines points of the polygon.
    *    "Star" {string}, defines a star-object. The pArg.edges property defines the number of edges of the star. The pArg.startAngle property defines the angle (radians) the star-object starts from. The pArg.deep defines the star's deepness, while pArg.tilt defines the star's tile as a number betwee 0 and 1
    *    "Spline" {string}, defines the Catmull-Rom spline-primitive (a curve that goes through its control points). The pArg.points property defines the control-points of the curve. The pArg.tension property specifies the tension of the curve, as a value ptFrom 0(round) to 1 (rectangular). The pArg.alpha specifies the alpha of the curve (0.5 by default), while pArg.closed defines a closed curve
    *    "Summary" {string}, defines a summary-object (outlines the summary-bar)
    *    "Deadline" {string}, defines a deadline-object (outlines the deadline-bar)
    *
    * @type {string}
    * @example
    *
    *   null {null}, defines a rectangular-object
    *   "Ellipse" {string}, defines an elliptic-object
    */
     primitive: "RoundRect",
    /**
     * @description The pArg field holds different properties to customize the object's primitive (see also primitive).
     * @type {object}
    */
    pArg:
    {
      /**
       * @description The x field defines the x-radius of the round-rectangle object.
       *
       * The x field has effect only if the primitive is:
       *
       *  "RoundRect", defines a round-rectangle
       *  "BevelRect", defines a bevel-rectangle
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates no round-corner for x-axis
       *  8 {number}, defines a round corner (of 8-pixels radius) for x-axis
      */
       x: 2,
      /**
       * @description The y field defines the y-radius of the round-rectangle object.
       *
       * The y field has effect only if the primitive is:
       *
       *  "RoundRect", defines a round-rectangle
       *  "BevelRect", defines a bevel-rectangle
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates no round-corner for y-axis
       *  8 {number}, defines a round corner (of 8-pixels radius) for y-axis
      */
       y: 2,
      /**
       * @description The startAngle field defines the angle (radians) the object's primitive starts from.
       *
       * The startAngle field has effect only if the primitive is:
       *
       *  "Arc", defines an arc-object
       *  "Pie", defines a pie-object
       *  "EllipticPolygon", defines an elliptic-polygon-object
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates that the primitive starts at 0 degree (12 o'clock)
       *  -Math.PI/2 {number}, starts at -90 degree (9 o'clock)
      */
       startAngle: undefined,
      /**
       * @description The sweepAngle field defines the length (as an angle in radians) of the object's primitive.
       *
       * The sweepAngle field has effect only if the primitive is:
       *
       *  "Arc", defines an arc-object
       *  "Pie", defines a pie-object
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates a zero-length (the primitive may not be visible while length is 0)
       *  Math.PI/2 {number}, defines the 90 degree length.
      */
       sweepAngle: undefined,
      /**
       * @description The edges field defines the number of edges of the object's primitive. It should be greater or equal than 3.
       *
       * The edges field has effect only if the primitive is:
       *
       *  "EllipticPolygon", defines an elliptic-polygon-object
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines a triangle
       *  3 {number}, defines a triangle
       *  8 {number}, defines an octagon
      */
       edges: undefined,
      /**
       * @description The points field defines the points object's polygon, or the control-points of the spline-curve. Defines the points object's polygon as an array of [[x,y]] or [{x,y}] type. There must be more than 3-points defines.
       *
       * The points field has effect only if the primitive is:
       *
       *  "Polygon", defines a polygon-object.
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {array}
       * @example
       *
       *  [[0,100],[50,0],[100,100]] {array}, defines a triangle
       *  [{x:0,y:100},{x:50,y:0},{x:100,y:100}] {array}, defines a triangle
      */
       points: undefined,
      /**
       * @description The deep field defines star's deep (defines the isotoxal star-polygon's deepnnes).
       *
       * The deep field has effect only if the primitive is:
       *
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the start's default deep as a result of sin(PI/edges) expression based on the number of edges the star has.
       *  0 {number}, the star is equivalent with an elliptic-polygon
       *  0.5 {number}, defines the star's deep to 0.5 (half of the radius)
      */
       deep: undefined,
      /**
       * @description The tilt field defines star's tilt.  Defines star's tilt as a number between 0 and 1.
       *
       * The tilt field has effect only if the primitive is:
       *
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the start's default tilt (0.5).
       *  0 {number}, the star' vertices go more to right
       *  1 {number}, the star' vertices go more to left
      */
       tilt: undefined,
      /**
       * @description The tension field specifies the tension of the curve(spline), as a value from 0(round) to 1 (rectangular)
       *
       * The tension field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  0 {number} or null {null}, defines the spline's default tension (0 or round)
       *  1 {number}, the curve shows as rectangular
      */
       tension: undefined,
      /**
       * @description The tension field specifies the alpha of the curve(spline), as a value from 0 to 1
       *
       * The alpha field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the spline's default alpha (0.5)
      */
       alpha: undefined,
      /**
       * @description The closed field defines a closed spline(curve)
       *
       * The closed field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  false {boolean} or null {null}, defines an opened spline-curve
       *  true {boolean}, defines a closed spline-curve
      */
       closed: undefined
    },
    /**
    * @description The draw field specifies a callback function to let you perform custom drawing on the current object. By default, the draw field is null, which indicates that it has no effect. Indicates a function, to perform additional drawing on the current object. The draw supports two parameters as follows:
    *
    *  ctx {object}, An object of CanvasRenderingContext2D type that specifies the context to draw
    *  client {array}, Indicates an array of [x,y,width,height] type that specfies the original client area to paint the object.
    *
    * During the callback the this keyword reffers the current object object.
    *
    * @type {callback}
    */
     draw: null
  }
}
/**
 * @description The exontrol.helpTFI namespace provides documentation for exontrol.TFI object, which holds font attributes to displays a text or a portion of text
*/
exontrol.helpTFI =
{
  /**
  * @description The tfi field applies font attributes to 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}.
  *
  * 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" {string}, defines Monospace font of 16px height, bold
  *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
  */
  tfi:
  {
    /**
     * @description The bold field specifies whether characters in text should be displayed in bold (equivalent of <b> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is displayed in bold
     *  false {boolean}, displays normal text
    */
     bold: false,
    /**
     * @description The italic field specifies whether characters in text should be displayed in italics (equivalent of <i> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is displayed in italics
     *  false {boolean}, displays normal text
    */
     italic: false,
    /**
     * @description The underline field specifies whether characters in text are underlined (equivalent of <u> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that the text is underlined
     *  false {boolean}, displays normal text
    */
     underline: false,
    /**
     * @description The strikeout field specifies whether characters in text are strike-through (equivalent of <s> tag of ex-HTML captions).
     * @type {boolean}
     * @example
     *
     *  true {boolean}, indicates that characters in text are strike-through
     *  false {boolean}, displays normal text
    */
     strikeout: false,
    /**
     * @description The fgcolor field specifies the text's foreground color (equivalent of <fgcolor color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the fgcolor field is ignored
     *  "red" {string}, displays the text in red color
     *  "rgb(255,0,0)" {string}, displays the text in red color
     *  "rgba(255,0,0,0.5)" {string}, displays the text in semi-transparent red color
    */
     fgColor: null,
    /**
     * @description The bgcolor field specifies the text's background color (equivalent of <bgcolor color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the bgcolor field is ignored
     *  "red" {string}, displays the text's background in red color
     *  "rgb(255,0,0)" {string}, displays the text's background in red color
     *  "rgba(255,0,0,0.5)" {string}, displays the text's background in semi-transparent red color
    */
     bgColor: null,
    /**
     * @description The fontSize field defines the size to display the font (equivalent of <font family;size> tag of ex-HTML captions).
     * @type {number}
     * @example
     *
     *  null {null}, specifies that the fontSize field is ignored
     *  12 {number}, defines the size of the font to 12 pixels
    */
     fontSize: null,
    /**
     * @description The fontName field defines family of the font to show the text (equivalent of <font family;size> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the fontName field is ignored
     *  "Georgia" {string}, indicates Georgia font family
    */
     fontName: null,
    /**
     * @description The shacolor field defines the text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
     * @type {object}
    */
    shaColor:
    {
      /**
       * @description The color field specifies the color for text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {string}
       * @example
       *
       *  null {null}, specifies that the color field is ignored
       *  "red" {string}, defines red shadow for text
       *  "rgb(255,0,0)" {string}, defines red shadow for text
       *  "rgba(255,0,0,0.5)" {string}, defines semi-transparent red shadow for text
      */
       color: null,
      /**
       * @description The width field defines the size of text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {number}
       * @example
       *
       *  null {null}, specifies that the width field is ignored
       *  4 {number}, indicates a 4-pixels wide for text's shadow
      */
       width: null,
      /**
       * @description The offset field defines the offset of text's shadow (equivalent of <sha color;width;offset> tag of ex-HTML captions).
       * @type {number}
       * @example
       *
       *  null {null}, specifies that the offset field is ignored
       *  4 {number}, shows the text's shadow with a different offset
      */
       offset: null
    },
    /**
     * @description The outcolor field defines color to show outlined text (equivalent of <out color> tag of ex-HTML captions).
     * @type {string}
     * @example
     *
     *  null {null}, specifies that the outcolor field is ignored
     *  "red" {string}, defines a red-outlined text
     *  "rgb(255,0,0)" {string}, defines a red-outlined text
     *  "rgba(255,0,0,0.5)" {string}, defines a semi-tranparent red-outlined text
    */
     outColor: null,
    /**
     * @description The gracolor field specifies whether the text is show in gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions).
     * @type {object}
    */
    graColor:
    {
      /**
       * @description The color field specifies the color for text's gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions).
       * @type {string}
       * @example
       *
       *  null {null}, specifies that the color field is ignored
       *  "red" {string}, defines a red-gradient text
       *  "rgb(255,0,0)" {string}, defines a red-gradient text
       *  "rgba(255,0,0,0.5)" {string}, defines a semi-tranparent red-gradient text
      */
       color: null,
      /**
       * @description The mode field defines mode of the text's gradient (equivalent of <gra color;mode;blend> tag of ex-HTML captions). The mode is a value between 0 and 3, 1 if missing/null or undefined.
       * @type {number}
       * @example
       *
       *  0 {number}, defines the gradient from left to right
       *  1 {number}, defines the gradient from right to left
       *  2 {number}, defines the gradient from top to bottom
       *  3 {number}, defines the gradient from bottom to top
       *
      */
       mode: null,
      /**
       * @description The blend field defines gradient's blend value (equivalent of <gra color;mode;blend> tag of ex-HTML captions). Could be 0 or 1. Currently, the gradient's blend is not available
       * @type {number}
      */
       blend: null
    }
  }
}

/**
 * @description The exontrol.helpShape namespace provides documentation for exontrol.S objects.
*/
exontrol.helpShape =
{
  /**
  * @description The shape field includes definitions to draw shapes. An object of exontrol.Def.Shape type.
  * @type {object}
  */
  shape:
  {
    /**
     * @description The opacity field sets the opacity level of the object. It is a number between 0.0 (fully transparent) and 1.0 (fully opaque).
     * @type {number}
     * @example
     *
     *  null {null}, the opacity field is ignored
     *  0 {number}, completely transparent
     *  0.5 {number}, semi-transparent
     *  1 {number}, fully-opaque
    */
     opacity: null,
    /**
     * @description The client field specifies a collection of up to four expressions that can define a different client area to show the object (see also padding). A string expression of "[expression,expression,expression,expression]" type, that determines the x, y, width and height of the new client. The client field must starts with "[" and ends with "]", else it has no effect.
     *
     * Each expression supports the following keywords:
     *
     *   x {number}, defines the object's default-left position
     *   y {number}, defines the object's default-top position
     *   width {number}, indicates the default-width of the object
     *   height {number}, indicates the default-width of the object.
     *
     * @type {string}
     * @example
     *
     *   null {null}, the client field is ignored
     *   "[x+64,y-32]" {string}, displays the object at a different position (offset by 64-pixels on x-axis, and 32-pixels up on y-axis)
     *   "[x-8,y-4,width+2*8,height+2*4]" {string}, is equivalent of padding on [8,4]
     *   "[x+(width-16)/2,y+(height-16)/2,16,16]" {string}, centers a 16x16 rectangle inside the client
    */
     client: null,
    /**
     * @description The padding field defines how much the object's client area is increased or decreased (see also client)
     * @type {(number|string|array)}
     * @example
     *
     *   null {null}, indicates that the padding field is ignored
     *   4 {number}, increases the object's client with 2 * 4-pixels, which includes width and height
     *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
     *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
    */
     pad: null,
    /**
    * @description The fillColor field defines the color to show the object's background.
    * @type {string}
    * @example
    *
    *  null {null}, specifies that the fillColor field is ignored
    *  "transparent" {string}, fills the object's background with rgba(0,0,0,0)/transparent color
    *  "red" {string}, fills the object's background with red color
    *  "rgb(255,0,0)" {string}, fills the object's background with red color
    *  "rgba(255,0,0,0.5)" {string}, fills the object's background with semi-tranparent red color
    */
     fillColor: null,
    /**
    * @description The fillGradientColor field defines the gradient type and colors to show the object's background.
    * @type {string}
    *
    * The fillColor field defines the starting color. The fillGradientColor field has effect only if the fillColor field is defined (not null or undefined).
    *
    * The first field of the fillGradientColor field could start with any of the following:
    *
    *   "vertical", defines a vertical-gradient (default)
    *   "horizontal", defines a horizontal-gradient
    *   "diagonal", defines a diagonal-gradient
    *   "radial", defines a radial-gradient
    *
    * The next fields indicates the stop-colors.
    *
    * @example
    *
    *  null {null}, specifies that the fillGradientColor field is ignored, so no gradient is applied on the object's background.
    *  "black" {string}, specifies a vertical-gradient that starts from fillColor and ends on black.
    *  "horizontal,red,green,blue" {string}, specifies a horizontal-gradient that starts from fillColor, continues with red, green and ends on blue.
    *  "diagonal,red,rgba(0,255,0,0.5),blue" {string}, specifies a diagonal-gradient that starts from fillColor, continues with red, 50% green and ends on blue.
    *  "radial,black" {string}, specifies a radial/circular-gradient that starts from fillColor and ends on black.
    */
     fillGradientColor: null,
    /**
     * @description The clientText field specifies a collection of up to four expressions that defines the new client area to display the shape's text (equivalent of offset, pad), relative to the shape's client area. A string expression of "[expression,expression,expression,expression]" type, that determines the x, y, width and height of the new client text. The clientText field must starts with "[" and ends with "]", else it has no effect.
     *
     * Each expression supports the following keywords:
     *
     *   x {number}, defines the object's default-left position
     *   y {number}, defines the object's default-top position
     *   width {number}, indicates the default-width of the object
     *   height {number}, indicates the default-width of the object.
     *
     * @type {string}
     * @example
     *
     *   null {null}, the clientText field is ignored
     *   "[x+64,y-32]" {string}, displays the text at a different position (offset by 64-pixels on x-axis, and 32-pixels up on y-axis)
     *   "[x-8,y-4,width+2*8,height+2*4]" {string}, is equivalent of padding on [8,4]
     *   "[,,width-20]" {string}, narrows the text's client with 20 pixels on right
    */
     clientText: null,
    /**
    * @description The padText field defines the padding to display the object's caption (see also text).
    * @type {number}
    * @example
    *
    *   null {null}, indicates that the padText field is ignored
    *   4 {number}, increases the caption's client with 2 * 4-pixels, which includes width and height
    *   "8,4" {string}, increases the caption's width with 2 * 8-pixels and caption's height with 2 * 4-pixels
    *   [8,4] {array}, increases the caption's width with 2 * 8-pixels and caption's height with 2 * 4-pixels
    */
     padText: null,
    /**
    * @description The text field defines the caption to be displayed on the object. The caption/text supports ex-HTML tags as listed bellow:
    *
    *   "<b>text</b>", displays the text in bold.
    *   "<i>text</i>", displays the text in italics.
    *   "<u>text</u>", underlines the text.
    *   "<s>text</s>", strike-through text
    *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
    *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
    *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
    *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
    *   "<br>", defines a forced line-break
    *   "<r>", right aligns the text
    *   "<c>", centers the text
    *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
    *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
    *   "<off offset>text</off>", defines the vertical offset to display the text.
    *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
    *   "<out color[;width]>text</out>", shows the text with outlined characters
    *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
    *
    * @type {string}
    * @example
    *
    *   null {null}, ignores the text field
    *   "this is a <fgcolor red>test</fgcolor>" {string}, where "test" is displayed in red color
    *   "this is a <b><off 4>test</off></b> of ex-HTML caption" {string}, where "test" is displayed in bold with a different vertical-offset
    */
     text: null,
    /**
    * @description The formatText field specifies the format to display the object's caption.
    *
    * The exontrol.DrawTextFormatEnum type support the following flags:
    *
    *   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 <fgcolor> and </bgcolor> 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}, defines a single-line centered text (equivalent of exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextWordEllipsis )
    *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line text
    *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line text right/bottom-aligned
    */
     formatText: null,
    /**
    * @description The tfi field applies font attributes to 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}.
    *
    * 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" {string}, defines Monospace font of 16px height, bold
    *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
    */
     tfi: null,
    /**
    * @description The clipText field indicates whether the caption is clipped to object.
    * @type {boolean}
    * @example
    *
    *   false {boolean}, the text/caption is not cliped
    *   true {boolean}, the text/caption is cliped to the object's client-rectangle
    */
     clipText: false,
    /**
    * @description The frameColor field defines the color to show the object's frame (see also primitive).
    * @type {string}
    * @example
    *
    *  null {null}, specifies no frame
    *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent frame
    *  "red" {string}, defines a red-frame
    *  "rgb(255,0,0)" {string}, defines a red-frame
    *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-frame
    */
     frameColor: null,
    /**
    * @description The frameSize field defines size of the object's frame.
    * @type {number}
    * @example
    *
    *  null {null}, draws the frame, only if the frameColor is defined
    *  0 {number}, shows no frame
    *  4 {number}, defines a 4-pixels frame
    */
     frameSize: null,
    /**
    * @description The frameDash field defines style of the object's frame. An Array of numbers which specify distances to alternately draw a line and a gap (in coordinate space units). If the number of elements in the array is odd, the elements of the array get copied and concatenated.
    * @type {array}
    * @example
    *
    *  null {null}, defines a solid frame
    *  [] {array}, indicates a solid frame
    *  2 {number}, will become [2, 2, ...]
    *  [5, 15, 25] {array}, will become [5, 15, 25, 5, 15, 25, ...]
    */
     frameDash: null,
    /**
    * @description The frameJoin field determines how two connecting segments into the object's frame are joined together. There are three possible values for this property as follows:
    *
    *  "round", rounds off the corners of a object by filling an additional sector of disc centered at the common endpoint of connected segments. The radius for these rounded corners is equal to the line width.
    *  "bevel", fills an additional triangular area between the common endpoint of connected segments, and the separate outside rectangular corners of each segment.
    *  "miter", connected segments are joined by extending their outside edges to connect at a single point, with the effect of filling an additional lozenge-shaped area.
    *
    * @type {string}
    * @example
    *
    *  null {null}, defines a "miter" join
    *  "round" {string}, rounds off the corners of a object by filling an additional sector of disc centered at the common endpoint of connected segments.
    */
     frameJoin: null,
    /**
    * @description The frameCap field determines how the end points of every line into the object's frame are drawn. There are three possible values for this property as follows:
    *
    *  "butt", the ends of lines are squared off at the endpoints.
    *  "round", the ends of lines are rounded
    *  "square", the ends of lines are squared off by adding a box with an equal width and half the height of the line's thickness.
    *
    * @type {string}
    * @example
    *
    *  null {null}, indicates "but" style
    *  "round" {string}, the ends of lines are rounded
    */
     frameCap: null,
    /**
    * @description The pattern field defines the pattern to show on the object's background (see also patternColor).
    *
    * The exontrol.PatternEnum type defines the following values:
    *
    *   exPatternEmpty (0), defines no pattern
    *   exPatternSolid (1), defines a solid-pattern
    *   exPatternDot (2), defines a dot-pattern
    *   exPatternShadow (3), defines a shadow-pattern
    *   exPatternNDot (4), defines a not-dot-pattern
    *   exPatternFDiagonal (5), defines a forward-diagonal-pattern
    *   exPatternBDiagonal (6), defines a backward-diagonal-pattern
    *   exPatternDiagCross (7), defines a cross-diagonal-pattern
    *   exPatternVertical (8), defines a vertical-pattern
    *   exPatternHorizontal (9), defines a horizontal-pattern
    *   exPatternCross (10), defines a cross-pattern
    *   exPatternBrick (11), defines a brick-pattern
    *   exPatternYard (12), defines a yard-pattern
    *
    * @type {exontrol.PatternEnum}
    * @example
    *
    *  null {null}, defines no pattern
    *  0 or exontrol.PatternEnum.exPatternEmpty {number}, defines an empty pattern (no pattern)
    *  7 or exontrol.PatternEnum.exPatternDiagCross {number}, defines a cross-diagonal-pattern
    */
     pattern: null,
    /**
    * @description The patternColor field defines the color to show the object's pattern (see also pattern).
    * @type {string}
    * @example
    *
    *  null {null}, indicates a black-color
    *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent pattern
    *  "red" {string}, defines a red-pattern
    *  "rgb(255,0,0)" {string}, defines a red-pattern
    *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-pattern
    */
     patternColor: null,
    /**
     * @description The shadow field holds information about box's shadow.
     * @type {object}
     */
    shadow:
    {
      /**
      * @description The color field defines the shadow's color. Defines the shadow's color in CSS format. The color, x or y properties have no effect while blur property is not defined.
      * @type {string}
      * @example
      *
      *  null {null}, indicates that the frameColor or fillColor property determines the shadow's color
      *  "transparent" or "rgba(0,0,0,0)"  {string}, defines a transparent shadow
      *  "red" {string}, defines a red-shadow
      *  "rgb(255,0,0)" {string}, defines a red-shadow
      *  "rgba(255,0,0,0.5)" {string}, defines a 50% red-shadow
      */
       color: null,
      /**
      * @description The blur field defines the blur level for shadows.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates no shadow
      *  4 {number}, defines shadow's blur to 4
      */
       blur: 0,
      /**
      * @description The x field defines the horizontal distance of the shadow from the object. Defines horizontal distance of the shadow from the object. The color, x or y properties have no effect while blur property is not defined.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates the shadow's x-offset at 0
      *  -4 {number}, defines shadow's x-offset to -4
      *  4 {number}, defines shadow's x-offset to 4
      */
       x: 0,
      /**
      * @description The y field defines vertical distance of the shadow from the object. By default, it is 0.
      * @type {number}
      * @example
      *
      *  0 {number}, indicates the shadow's y-offset at 0
      *  -4 {number}, defines shadow's y-offset to -4
      *  4 {number}, defines shadow's y-offset to 4
      */
       y: 0
    },
    /**
    * @description The primitive field defines the type of frame the object is displaying (see also pArg)
    *
    *  The primitive could be any of the following predefined values:
    *
    *    "Rect" {string}, defines a rectangular-object
    *    "RoundRect" {string}, defines a round rectangular-object. The pArg.x, pArg.y define the radius of round-corners.
    *    "BevelRect" {string}, defines a bevel rectangular-object. The pArg.x, pArg.y define the radius of round-corners.
    *    "Ellipse" {string}, defines an elliptic-object
    *    "Pie" {string}, defines a pie-object. The pArg.startAngle property defines the angle (radians) the pie starts from. The pArg.sweepAngle property defines the length (radians) of the pie.
    *    "Arc" {string}, defines an arc-object. The pArg.startAngle property defines the angle (radians) the arc starts from. The pArg.sweepAngle property defines the length (radians) of the arc.
    *    "Oval" {string}, defines an oval-object.
    *    "Circle" {string}, defines a circle-object.
    *    "Triangle" {string}, defines a triangle-object.
    *    "EllipticPolygon" {string}, defines an elliptic-polygon-object. The pArg.edges property defines the number of edges within the elliptic-polygon. The pArg.startAngle property defines the angle (radians) the elliptic-polygon starts from.
    *    "Polygon" {string}, defines a polygon-object. The pArg.points property defines points of the polygon.
    *    "Star" {string}, defines a star-object. The pArg.edges property defines the number of edges of the star. The pArg.startAngle property defines the angle (radians) the star-object starts from. The pArg.deep defines the star's deepness, while pArg.tilt defines the star's tile as a number betwee 0 and 1
    *    "Spline" {string}, defines the Catmull-Rom spline-primitive (a curve that goes through its control points). The pArg.points property defines the control-points of the curve. The pArg.tension property specifies the tension of the curve, as a value ptFrom 0(round) to 1 (rectangular). The pArg.alpha specifies the alpha of the curve (0.5 by default), while pArg.closed defines a closed curve
    *    "Summary" {string}, defines a summary-object (outlines the summary-bar)
    *    "Deadline" {string}, defines a deadline-object (outlines the deadline-bar)
    *
    * @type {string}
    * @example
    *
    *   null {null}, defines a rectangular-object
    *   "Ellipse" {string}, defines an elliptic-object
    */
     primitive: "RoundRect",
    /**
     * @description The pArg field holds different properties to customize the object's primitive (see also primitive).
     * @type {object}
    */
    pArg:
    {
      /**
       * @description The x field defines the x-radius of the round-rectangle object.
       *
       * The x field has effect only if the primitive is:
       *
       *  "RoundRect", defines a round-rectangle
       *  "BevelRect", defines a bevel-rectangle
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates no round-corner for x-axis
       *  8 {number}, defines a round corner (of 8-pixels radius) for x-axis
      */
       x: 2,
      /**
       * @description The y field defines the y-radius of the round-rectangle object.
       *
       * The y field has effect only if the primitive is:
       *
       *  "RoundRect", defines a round-rectangle
       *  "BevelRect", defines a bevel-rectangle
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates no round-corner for y-axis
       *  8 {number}, defines a round corner (of 8-pixels radius) for y-axis
      */
       y: 2,
      /**
       * @description The startAngle field defines the angle (radians) the object's primitive starts from.
       *
       * The startAngle field has effect only if the primitive is:
       *
       *  "Arc", defines an arc-object
       *  "Pie", defines a pie-object
       *  "EllipticPolygon", defines an elliptic-polygon-object
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates that the primitive starts at 0 degree (12 o'clock)
       *  -Math.PI/2 {number}, starts at -90 degree (9 o'clock)
      */
       startAngle: undefined,
      /**
       * @description The sweepAngle field defines the length (as an angle in radians) of the object's primitive.
       *
       * The sweepAngle field has effect only if the primitive is:
       *
       *  "Arc", defines an arc-object
       *  "Pie", defines a pie-object
       *
       * @type {number}
       * @example
       *
       *  0 {number}, indicates a zero-length (the primitive may not be visible while length is 0)
       *  Math.PI/2 {number}, defines the 90 degree length.
      */
       sweepAngle: undefined,
      /**
       * @description The edges field defines the number of edges of the object's primitive. It should be greater or equal than 3.
       *
       * The edges field has effect only if the primitive is:
       *
       *  "EllipticPolygon", defines an elliptic-polygon-object
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines a triangle
       *  3 {number}, defines a triangle
       *  8 {number}, defines an octagon
      */
       edges: undefined,
      /**
       * @description The points field defines the points object's polygon, or the control-points of the spline-curve. Defines the points object's polygon as an array of [[x,y]] or [{x,y}] type. There must be more than 3-points defines.
       *
       * The points field has effect only if the primitive is:
       *
       *  "Polygon", defines a polygon-object.
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {array}
       * @example
       *
       *  [[0,100],[50,0],[100,100]] {array}, defines a triangle
       *  [{x:0,y:100},{x:50,y:0},{x:100,y:100}] {array}, defines a triangle
      */
       points: undefined,
      /**
       * @description The deep field defines star's deep (defines the isotoxal star-polygon's deepnnes).
       *
       * The deep field has effect only if the primitive is:
       *
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the start's default deep as a result of sin(PI/edges) expression based on the number of edges the star has.
       *  0 {number}, the star is equivalent with an elliptic-polygon
       *  0.5 {number}, defines the star's deep to 0.5 (half of the radius)
      */
       deep: undefined,
      /**
       * @description The tilt field defines star's tilt.  Defines star's tilt as a number between 0 and 1.
       *
       * The tilt field has effect only if the primitive is:
       *
       *  "Star", defines a star-object
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the start's default tilt (0.5).
       *  0 {number}, the star' vertices go more to right
       *  1 {number}, the star' vertices go more to left
      */
       tilt: undefined,
      /**
       * @description The tension field specifies the tension of the curve(spline), as a value from 0(round) to 1 (rectangular)
       *
       * The tension field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  0 {number} or null {null}, defines the spline's default tension (0 or round)
       *  1 {number}, the curve shows as rectangular
      */
       tension: undefined,
      /**
       * @description The tension field specifies the alpha of the curve(spline), as a value from 0 to 1
       *
       * The alpha field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  null {null}, defines the spline's default alpha (0.5)
      */
       alpha: undefined,
      /**
       * @description The closed field defines a closed spline(curve)
       *
       * The closed field has effect only if the primitive is:
       *
       *  "Spline", defines a spline-curve (a curve that goes through its control points)
       *
       * @type {number}
       * @example
       *
       *  false {boolean} or null {null}, defines an opened spline-curve
       *  true {boolean}, defines a closed spline-curve
      */
       closed: undefined
    },
    /**
    * @description The draw field specifies a callback function to let you perform custom drawing on the current object. By default, the draw field is null, which indicates that it has no effect. Indicates a function, to perform additional drawing on the current object. The draw supports two parameters as follows:
    *
    *  ctx {object}, An object of CanvasRenderingContext2D type that specifies the context to draw
    *  client {array}, Indicates an array of [x,y,width,height] type that specfies the original client area to paint the object.
    *
    * During the callback the this keyword reffers the current object object.
    *
    * @type {callback}
    */
     draw: null
  }
}
/* @license Copyright (C) Exontrol. All rights reserved. */

/////////////////////////////////////////////////////////// (exontrol.Calendar)
//
//  The exontrol.Calendar class provides the following events (through oLts):
//
//     "ondatechange", notifies your application that the control's date has been changed. The ondatechange's parameter is:
//
//        oEvent {Date}, specifies the newly date that the control displays. The control's GetDate returns the same value.
//
//     "onselchanging", occurs once the control's selection is changing. The onselchanging's parameter could be any of the following:
//
//        oEvent {null}, indicates that the control has no selected dates
//        oEvent {Date}, indicates an object of Date type that defines the control's single-date selected
//        oEvent {array}, specifies an array of [Date] type that holds all selected dates within the control
//
//     "onselchange", notifies your application that the control's selection has been changed. The onselchange's parameter could be any of the following:
//
//        oEvent {null}, indicates that the control has no selected dates
//        oEvent {Date}, indicates an object of Date type that defines the control's single-date selected
//        oEvent {array}, specifies an array of [Date] type that holds all selected dates within the control
//
//     "onclick", occurs once the user clicks or double-clicks a date. The onclick's parameter is:
//
//        oEvent {object}, specifies an object of {dblClick,button,modifiers,..} type, that holds information about the object being clicked
//
//          oEvent.type {string}, specifies the type of the part being clicked
//          oEvent.date {Date}, specifies the date being clicked
//          oEvent.events {array}, holds the event being clicked, as an array of [exontrol.Calendar.Event] type
//          oEvent.dblClick {boolean}, indicates whether the user clicks or double-clicks the date
//          oEvent.button {number}, indicates which button is pressed while clicking the event as 1 (left), 2 (right) or 4 (middle)
//          oEvent.modifiers {number}, specifies a combination of 1, 2, 4 and 16 according with modifier keys (ALT, CTRL, META and SHIFT), or 0 if no modifier keys
//
//     "onanchorclick", (@since 2.2) occurs once the user clicks an anchor element (the <a id;options> ex-HTML part marks an anchor or hyperlink element). The onanchorclick's parameter is:
//
//        oEvent {object}, specifies an object of {id,options} type, that holds information about the anchor being clicked.
//
//          oEvent.id {string}, specifies null or the identifier of the anchor being clicked
//          oEvent.options {string}, specifies null or the options of the anchor being clicked
//
///////////////////////////////////////////////////////////

/////////////////////////////////////////////////////////// (exontrol.Def.Calendar)
//
// The exontrol.Def.Calendar namespace provides definitions for different objects, primitives, objects of exontrol.Calendar object
//
//  The exontrol.Def.Calendar namespace provides the following fields:
//
//   tfi {(string|object)}, holds the font attributes for captions within the control. The tfi field can be defined using a string representation such as &quot;b monospace 16&quot; or as an object such as {bold: true, fontName: &quot;monospace&quot;, 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.
//   readOnly {boolean}, indicates whether the control is read-only (the user can't select new dates, but can browse for any date, @since 1.8).
//   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.
//   events {object}, defines the events of the control
//
///////////////////////////////////////////////////////////

/**
 * @description The exontrol.Def.Calendar namespace provides definitions for different objects, primitives, objects of exontrol.Calendar object.
*/
exontrol.Def.Calendar =
{
  /**
  * @description The tfi field applies font attributes to 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}.
  *
  * 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" {string}, defines Monospace font of 16px height, bold
  *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
  */
   tfi: null,
  /**
  * @description The locale field specifies the language whose formatting conventions should be used to customize the calendar. A string with a BCP 47 language tag.
  * @type {string}
  * @example
  *
  *   null {null}, indicates that the browser's UI language is used.
  *   "de" {string}, defines German locale
  *   "ro" {string}, defines Romanian locale
  */
   locale: null,
  /**
   * @description The mode field specifies the orientation the calendar displays the days of the weeks.
   *
   * The exontrol.Calendar.ModeEnum type supports the following values:
   *
   *  exVertical(0), specifies that the days of the week are vertically arranged
   *  exHorizontal(1), specifies that the days of the week are horizontally arranged
   *
   * @type {exontrol.Calendar.ModeEnum}
   * @example
   *
   *  0 or exontrol.Calendar.ModeEnum.exVertical {number}, shows vertically the week days
   *  1 or exontrol.Calendar.ModeEnum.exHorizontal {number}, shows horizontally the week days
  */
   mode: exontrol.Calendar.ModeEnum.exHorizontal,
  /**
   * @description The flow field determines whether the months gets arranged from left to right or top to bottom.
   *
   * The exontrol.Calendar.FlowEnum type supports the following values:
   *
   *  exLeftToRight(0), indicates that the next month gets arranged to the right of the current month
   *  exTopToBottom(1), indicates that the next month gets arranged to the bottom of the current month
   *
   * @type {exontrol.Calendar.FlowEnum}
   * @example
   *
   *  0 or exontrol.Calendar.FlowEnum.exLeftToRight {number}, arranges months from left to right
   *  1 or exontrol.Calendar.FlowEnum.exTopToBottom {number}, arranges months from top to bottom
  */
   flow: exontrol.Calendar.FlowEnum.exLeftToRight,
  /**
   * @description The date field specifies the calendar's browsing date as string in format "#MM/DD/YYYY#"
   * @type {string}
   * @example
   *
   *  null {null}, browses today date
   *  "#12/31/1971#" {string}, browses December 31, 1971
  */
   date: null,
  /**
  * @description The autoSize field determines whether the size of the calendar's date is fixed, or relative to the current font or client area.
  *
  * The exontrol.Calendar.AutoSizeEnum type defines the following values:
  *
  *   exFontSize(-1), indicates that the size of the calendar's date is automatically computed based on the current font
  *   exFixedSize(0), specifies that the size of the calendar's date is fixed. The dayFixedWidth / dayFixedHeight specifies the size of the calendar's date while autoSize property is exontrol.Calendar.AutoSizeEnum.exFixedSize
  *   exFitClient(1), indicates that the size of the calendar's date is computed so entire calendar fits the control's client area
  *
  * @type {exontrol.Calendar.AutoSizeEnum}
  * @example
  *
  *   -1 or exontrol.Calendar.AutoSizeEnum.exFontSize {number}, defines the size of the calendar's date based on the current font.
  *   1 or exontrol.Calendar.AutoSizeEnum.exFitClient {number}, resizes the calendar's date to ensure all months fit the control's client area
  */
   autoSize: exontrol.Calendar.AutoSizeEnum.exFontSize,
  /**
  * @description The smoothSel field defines the time in ms the calendar's selection goes from one state to another.
  * @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.
  */
   smoothSel: 125,
  /**
  * @description The smoothScroll field defines the time in ms the calendar's date scrolls to another.
  * @type {number}
  * @example
  *
  *   0 {number}, no smooth changes once the control goes from a layout to another
  *   250 {number}, specifies that a smooth-transition is performed from a layout to another for 250 ms.
  */
   smoothScroll: 250,
  /**
  * @description The locked field indicates whether the control is locked(protected) or unlocked
  * @type {boolean}
  * @example
  *
  *   false {boolean}, unlocks the control (can select any date)
  *   true {boolean}, locks the control (can't select any date)
  */
   locked: false,
  /**
   * @description The readOnly field indicates whether the control is read-only (the user can't select new dates, but can browse for any date)
   * @type {boolean}
   * @since 1.8
   * @example
   *
   *   false {boolean}, the user can select new dates
   *   true {boolean}, the user can not select dates
  */
   readOnly: false,
  /**
   * @description The selection field specifies the selected date(s). Indicates the control's selection, as one of the following:
   *
   *  {null}, clears the control's selection
   *  {string}, defines the date to select in string-format as "#MM/DD/YYYY[ HH:mm:ss]#" or string-format as "YYYY-MM-DDTHH:mm:ss.sssZ" (ISO 8601), such as "2011-10-10" (date-only format), "2011-10-10T14:48:00" (local date-time format), "2011-10-10T14:48:00Z" (UTC date-time format), or "2011-10-10T14:48:00.000+09:00" (date-time format with milliseconds and time zone offset) (since 1.3)
   *  {number}, integer value representing the year of the date to be selected. For instance, 2022 goes for "Jan 1st, 2022"
   *  {Date}, indicates a JavaScript date to be selected
   *  {array}, indicates a collection of dates to be selected, as an array of [date] type, where date could be null, string, number or a Date expression
   *
   * @type {any}
   * @example
   *
   *  null {null}, clears the control's selection
   *  [null] {array}, selects today
   *  "#1/15/2022#" or "2022-1-15" {string}, selects the specified date
   *  2022 {number}, selects "Jan 1st, 2022"
   *  Date.Today().NextDay(1) {Date}, selects tomorrow
   *  Calendar.Collect(Date.Today(), null, Calendar.CollectEnum.exWeek) {Date}, selects the current week (in case the control allows multiple selection, else it selects the first day of the current week)
   *  [null,Date.Today().NextDay(1)] {array}, selects today and tommorow date
   *  ["#1/13/2022#","#1/15/2022#"] {array}, selects Jan 13 and 15 of 2022
  */
   selection: null,
  /**
   * @description The singleSel field specifies whether the control supports single, multiple, toggle selection.
   *
   * The exontrol.Calendar.SingleSelEnum type supports the following flags:
   *
   *  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 date only
   *  exToggleSel(4), specifies that the date's selection state is toggled once the user clicks a date.
   *  exDisableCtrlSel(8), disables toggling the date's selection state when user clicks a date, while CTRL modifier key is pressed.
   *  exDisableShiftSel(16), disables selecting dates using the SHIFT key.
   *  exDisableDrag(32), disables selecting dates by drag.
   *
   * @type {exontrol.Calendar.SingleSelEnum}
   * @example
   *
   *  0 or exontrol.Calendar.SingleSelEnum.exDisableSel {number}, disables selecting any date
   *  3 or exontrol.Calendar.SingleSelEnum.exSingleSel | exontrol.Calendar.SingleSelEnum.exEnableSel {number}, enables control's single selection, so only a single date can be selected
   *  6 or exontrol.Calendar.SingleSelEnum.exToggleSel | exontrol.Calendar.SingleSelEnum.exSingleSel {number}, enables control's single and toggle selection, which means that once a date is selected it gets unselected once it is clicked, or reverse, and only a single-date can be selected at once.
  */
   singleSel: exontrol.Calendar.SingleSelEnum.exEnableSel,
  /**
   * @description The allowSwitchView field specifies whether the user can switch the view (month or year).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, disables month or year view
   *  true {boolean}, enables month or year view
  */
   allowSwitchView: true,
  /**
   * @description The allowScrollByDrag field specifies whether the user can scroll the control by drag.
   * @type {boolean}
   * @example
   *
   *  false {boolean}, disables scrolling the control while user drags outside
   *  true {boolean}, the user can scrolls the control by drag (click a month area where no dates is displayed and drag in any direction to get control scrolled)
  */
   allowScrollByDrag: true,
  /**
   * @description The padCal field specifies the padding to display the calendar. Defines a numeric, string or array value that determines the padding to be applied.
   * @type {(number|string|array)}
   * @example
   *
   *   null {null}, indicates that the default-padding field is used (4)
   *   0 {number}, indicates no padding
   *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
   *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
  */
   padCal: 4,
  /**
   * @description The alignCal field aligns the calendar relative to the canvas.
   *
   * The exontrol.AlignEnum type supports the following values:
   *
   *  exAlignTop (0x00), justifies the object to the top of the rectangle
   *  exAlignLeft (0x00), aligns object to the left
   *  exAlignCenter (0x01), centers object horizontally in the rectangle
   *  exAlignRight (0x02), aligns object to the right
   *  exAlignVCenter (0x04), centers object vertically
   *  exAlignBottom (0x08), justifies the object to the bottom of the rectangle
   *
   * @type {exontrol.AlignEnum}
   * @example
   *
   *  0 or exontrol.AlignEnum.exAlignTop | exontrol.AlignEnum.exAlignLeft {number}, aligns the calendar to the top-left corner
   *  5 or exontrol.AlignEnum.exAlignCenter | exontrol.AlignEnum.exAlignVCenter {number}, centers the calendar
  */
   alignCal: exontrol.AlignEnum.exAlignCenter | exontrol.AlignEnum.exAlignVCenter,
  /**
  * @description The wheelChange field specifies the amount the calendar scrolls when the user rolls the mouse wheel.
  * @type {number}
  * @example
  *
  *   0 {number}, locks any action the mouse's wheel performs
  *   1 {number}, advances one month back or forward once the user rotates the mouse wheel
  */
   wheelChange: 1,
  /**
  * @description The minMonthX field specifies the minimum number of months horizontally displayed.
  *
  * The minMonthX and maxMonthX properties determines the number of months horizontally displayed. The number of months horizontally displayed depends on the month's size and the canvas's size. If the minMonthX and maxMonthX properties are equal it specifies exactly the months horizontally displayed.
  *
  * @type {number}
  * @example
  *
  *   2 {number}, indicates that the calendar displays minimum two months
  */
   minMonthX: 1,
  /**
  * @description The maxMonthX field specifies the maximum number of months horizontally displayed.
  *
  * The minMonthX and maxMonthX properties determines the number of months horizontally displayed. The number of months horizontally displayed depends on the month's size and the canvas's size. If the minMonthX and maxMonthX properties are equal it specifies exactly the months horizontally displayed.
  *
  * @type {number}
  * @example
  *
  *   6 {number}, indicates that the calendar displays maximum six months.
  */
   maxMonthX: 6,
  /**
  * @description The minMonthY field specifies the minimum number of months vertically displayed.
  *
  * The minMonthY and maxMonthY properties determines the number of months vertically displayed. The number of months vertically displayed depends on the month's size and the canvas's size. If the minMonthY and maxMonthY properties are equal it specifies exactly the months vertically displayed.
  *
  * @type {number}
  * @example
  *
  *   2 {number}, indicates that the calendar displays minimum two months
  */
   minMonthY: 1,
  /**
  * @description The maxMonthY field specifies the maximum number of months vertically displayed.
  *
  * The minMonthY and maxMonthY properties determines the number of months vertically displayed. The number of months vertically displayed depends on the month's size and the canvas's size. If the minMonthY and maxMonthY properties are equal it specifies exactly the months vertically displayed.
  *
  * @type {number}
  * @example
  *
  *   6 {number}, indicates that the calendar displays maximum six months.
  */
   maxMonthY: 2,
  /**
   * @description The padding field specifies the padding to be applied on dates of the calendar. Defines a numeric, string or array value that determines the padding to be applied.
   * @type {(number|string|array)}
   * @example
   *
   *   null {null}, indicates that the default-padding field is used ([4,2])
   *   0 {number}, indicates no padding
   *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
   *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
  */
   pad: [4,2],
  /**
   * @description The dayLabel field indicates a ex-HTML string that can include expression fields (<%...%>) to display the date while the calendar is in day-view.
   *
   * Defines a ex-HTML string that can include expression fields (<%...%>) to display the date while the calendar is in day-view.
   *
   * The dayLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "<%d%>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31),
   *  "<%dd%>" {string}, displays day of the month in two numeric digits (01 to 31)
   *  "<%d%>\n<font ;8><fgcolor gray><%y%></fgcolor>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31) on the first line, and on the second line displays the number of the day of the year (1 to 366) in gray
  */
   dayLabel: "<%d%>",
  /**
   * @description The dayAlign field aligns the date's label, while the calendar is in day-view. A combination of one or more exontrol.DrawTextFormatEnum flags that defines the way the date's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   dayAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextNoClip,
  /**
   * @description The dayFixedWidth field defines the width of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
   *
   * The dayFixedWidth field has effect only if the autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize. The dayFixedWidth property does not include the date's padding.
   *
   * @type {number}
   * @example
   *
   *  24 {number}, defines the date's width to 24-pixels
  */
   dayFixedWidth: 24,
  /**
   * @description The dayFixedHeight field defines the height of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
   *
   * The dayFixedHeight field has effect only if the autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize. The dayFixedHeight property does not include the date's padding.
   *
   * @type {number}
   * @example
   *
   *  24 {number}, defines the date's height to 24-pixels
   */
   dayFixedHeight: 24,
  /**
   * @description The dayWeekHeader field specifies whether the calendar shows the header to display the days of the week (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the header that displays the days of the week (day-view only).
   *  true {boolean}, shows the header that displays the days of the week (day-view only).
  */
   dayWeekHeader: true,
  /**
   * @description The dayWeekLabel field defines the ex-HTML label to show the days of the week into the calendar's header (day-view only). Specifies the ex-HTML label to show the days of the week into the calendar's header (day-view only).
   *
   * The dayWeekLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%d2%>" {string}, displays first two letters of the weekday (Su to Sa)
   *  "<b><%d3%></b>" {string}, displays first thee letters of the weekday (Sun to Sat) in bold
  */
   dayWeekLabel: "<%d2%>",
  /**
   * @description The dayWeekNoHeader field specifies whether the calendar shows the header to display week-number (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the calendar's header that displays the week-number
   *  true {boolean}, shows the calendar's header that displays the week-number
  */
   dayWeekNoHeader: true,
  /**
   * @description The dayWeekNoLabel field defines the ex-HTML label to show the week-number into the calendar's header (day-view only). Specifies the ex-HTML label to show the week-number into the calendar's header (day-view only).
   *
   * The dayWeekNoLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekNoLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%ww%>" {string}, displays the week of the year (1 to 53)
   *  "<fgcolor red><%ww%></fgcolor>" {string}, displays the week of the year (1 to 53) in red
  */
   dayWeekNoLabel: "<%ww%>",
  /**
   * @description The dayMonthHeader field specifies whether the calendar shows the header to display month's name (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the calendar's header (month's name)
   *  true {boolean}, shows the calendar's header (month's name)
  */
   dayMonthHeader: true,
  /**
   * @description The dayMonthLabel field defines the ex-HTML label to show the month-name into the calendar's header (day-view only). Specifies the ex-HTML label to show the month-name into the calendar's header (day-view only).
   *
   * The dayMonthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayMonthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%mmm%>" {string}, displays three-letters of the month
   *  "<%mmmm%> <%yyyy%>" {string}, displays the full month and year
   *  "<b><%mmm%></b><r><fgcolor gray><font ;8><off 6><%yyyy%>" {string}, displays an combined ex-HTML format
  */
   dayMonthLabel: "<%mmmm%> <%yyyy%>",
  /**
   * @description The dayMonthAlign field aligns the month's label, while the calendar is in day-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the date's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   dayMonthAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextNoClip,
  /**
   * @description The dayNonMonth field specifies whether the calendar displays the dates that are not part of the current month.
   * @type {number}
   * @example
   *
   *  false {boolean}, hides the dates that are not part of the current month.
   *  true {boolean}, shows the dates that are not part of the current month.
  */
   dayNonMonth: true,
  /**
   * @description The dayNonMonthLabel field defines the ex-HTML label to show the dates that are not part of the current month (day-view only). Specifies the ex-HTML label to show the dates that are not part of the current month (day-view only).
   *
   * The dayNonMonthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayNonMonthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%d%>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31)
   *  "<fgcolor lightgray><%d%></fgcolor>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31) in gray
  */
   dayNonMonthLabel: "<%d%>",
  /**
   * @description The dayWeekAllLabel field 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). Specifies 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).
   *
   * The dayWeekAllLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekAllLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<b><%mr%>" {string}, displays month of the year in Roman numerals, as needed (I to XII) in bold
  */
   dayWeekAllLabel: "",
  /**
   * @description The monthLabel field specifies the ex-HTML string that can include expression fields (<%...%>) to display the month while the calendar is in month-view. Defines the ex-HTML string that can include expression fields (<%...%>) to display the month while the calendar is in month-view.
   *
   * The monthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, monthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%mmm%>" {string}, displays first three letters of the month (Jan to Dec)
  */
   monthLabel: "<%mmm%>",
  /**
   * @description The monthAlign field aligns the month's label, while the calendar is in month-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the month's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   monthAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextWordEllipsis,
  /**
   * @description The monthYearAlign field aligns the year's label, while the calendar is in month-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the year's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   monthYearAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The yearLabel field specifies the ex-HTML string that can include expression fields (<%...%>) to display the year while the calendar is in year-view. Defines the ex-HTML string that can include expression fields (<%...%>) to display the year while the calendar is in year-view.
   *
   * The yearLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, yearLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%yyyy%>" {string}, displays the year with four digits
  */
   yearLabel: "<%yyyy%>",
  /**
   * @description The yearAlign field aligns the year's label, while the calendar is in year-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the year's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   yearAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The yearRangeAlign field aligns the label that displays the range of years, while the calendar is in year-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the label that displays the range of years is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   yearRangeAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The shapes field defines the shapes each part of the control can display. The shapes field customizes the control's visual appearance.
   *
   * The format of shapes property is:
   *
   *  "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": &quot;RoundRect&quot;,&quot;fillColor&quot;:&quot;black&quot;,&quot;tfi&quot;: {&quot;fgColor&quot;: "white"}}}')
   *    specifies the name of the field within the exontrol.Shapes.Calendar object (while it starts with a lowercase letter, such as today which refers to exontrol.Shapes.Calendar.today 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 bellow)
   *
   * The shapes property supports any of the following parts:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @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(dt)", "#FF0000(dt)", "rgb(255,0,0)(dt)", "rgba(255,0,0,1)(dt)" {string}, shows "today" in red
   *  '{"normal":{"fillColor":"lightgray","primitive":"Circle"},"hover":{"frameColor":"black"}}(d)' {string}, shows all-days within a circle, and draws a black-frame when hovers it
   *  "xxx(d),yyy(d,m),zzz(y)"  {string}, specifies that the exontrol.Shapes.Calendar.xxx combined with exontrol.Shapes.Calendar.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.Calendar.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.Calendar.zzz object defines the visual appearance of "y" part of the control
  */
   shapes: "hframe2(d,dnm,m,y),header(dmh,mh,yh),today(dt,mt,yt),gray(dw,dwn,dwnn),lightgray(dnm),select(ds,ms,ys),weekend(de),prev(p),next(n)",
  /**
   * @description The hlShapes field defines the shape(s) to be applied on a part of the control, when it requires to be highlighted
   *
   * The format of hlShapes property is:
   *
   *  "shape(part),shape(part),..."
   *
   * where:
   *
   *  "shape", indicates the name of the sub-object within the exontrol.Shapes.Calendar or exontrol.Shapes namespace to be applied on the part (also it can be a CSS color or a JSON string-representation of a {normal,disabled,hover,click} or exontrol.Def.Shape object),
   *  "part", defines the name of the part the shape is applied on (as defined bellow)
   *
   * The hlShapes property supports any of the following parts:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @type {string}
   * @example
   *
   *  null {null}, specifies the default visual appearance
   *  "" {string}, no shape (no visual appearance is applied to any part of the control)
   *  "star(d,dnm,dwa)" {string}, indicates that a exontrol.Shapes.Calendar.star object is applied on "d", "dnm" and "dwa" parts of the control.
   *  "xxx(d),yyy(d,m),zzz(y)" {string}, specifies that the exontrol.Shapes.Calendar.xxx combined with exontrol.Shapes.Calendar.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.Calendar.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.Calendar.zzz object defines the visual appearance of "y" part of the control
   */
   hlShapes: "highlight(m,dm,y),star(d,dnm,dwa)",
  /**
   * @description The cursors field specifies the mouse cursor to be displayed when pointing over a part of the control.
   *
   * The format of cursors property is:
   *
   *  "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 bellow)
   *
   * The "part" can be any of the following:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *  "anchor" (hyperlink), defines the mouse-cursor when the mouse pointer hovers the anchor (the <a> ex-HTML part marks an anchor or hyperlink element) (@since 2.2)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @type {string}
   * @example
   *
   *   "" {string}, no mouse cursor support
   *   "pointer(d,p,n)" {string}, indicates that the "pointer" mouse cursor is shown once the cursor hovers the "d", "p" or "n" parts of the control
  */
   cursors: "pointer(p,n,anchor)",
  /**
   * @description The toolTipDelay field specifies how long the mouse pointer must point to an object before the tool tip appears
   * @type {number}
   * @example
   *
   *   0 {number}, the tooltip is shown "immediately"
   *   128 {number}, the tooltip is displayed in 128 ms.
  */
   toolTipDelay: 500,
  /**
   * @description The toolTipPopDelay field specifies the period in ms of time the tool top remains visible if the mouse pointer is stationary within a control
   * @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: 5000,
  /**
   * @description The toolTipWidth field indicates the max-width of the control's tooltip (in pixels)
   * @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: -1,
  /**
   * @description The events field defines the events within the control. The events field can be any of the following:
   *
   *  {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 = [{date: "#1/1/2001#", shape: "red"}], {array} defines a single event
   *  Events =
   *  {
   *    "E1":
   *    {
   *      date: "#1/1/2001#",
   *      shape: "rgba(255,0,0,0.5)"
   *    },
   *    "E2":
   *    {
   *      date: "#1/1/2001#",
   *      shape: "rgba(255,255,0,0.5)"
   *    }
   *  }, {object} defines two events "E1" and "E2"
   *
  */
   events: null
}

/////////////////////////////////////////////////////////// (exontrol.Calendar.Events)
//
// The Events object holds a collection of Event type (event of the control)
//
// The Events object provides the following methods:
//
//  Add(oEventOpts) {Event}, creates and adds a new event into the control
//  Count/GetCount() {number}, returns the number of events within the collection.
//  Item(id) {Event}, gets the event giving its index, identifier/key or reference
//  Remove(id), removes the event giving its index, identifier/key or reference
//  Clear(), removes all events of the control
//
/////////////////////////////////////////////////////////// 

/////////////////////////////////////////////////////////// (exontrol.Calendar.Event)
//
// The Event object holds event objects of the control. The Add(oEventOpts) method of exontrol.Calendar.Events object creates and adds a new event into the control.
//
// The Event object provides the following methods:
//
//  Options/GetOptions()/SetOptions(value) {exontrol.Calendar.EventOptions}, indicates the event's options (at once) such as visibility, position and so on
//  Index/GetIndex() {number}, returns the index of the event (0-based)
//  Date/GetDate()/SetDate(value) {any}, indicates the date of the event
//  Key/GetKey()/SetKey(value) {any}, specifies the event's key (the Events.Item(key) requests an event by its index, identifier/key or reference)
//  Selectable/GetSelectable()/SetSelectable(value) {boolean}, specifies whether the user can select the date
//  Shape/GetShape()/SetShape(value) {any}, the shape for the event.
//  Cursor/GetCursor()/SetCursor(value) {string}, the mouse cursor for the event.
//  Repetitive/GetRepetitive()/SetRepetitive(value) {string}, returns or sets the expression to define the repetitive-event
//  ToolTip/GetToolTip()/SetToolTip(value) {string}, defines the event's predefined tooltip
//  UserData/GetUserData()/SetUserData(value) {any}, associates any extra-data with the event
//
// Also, the exontrol.Calendar.Event object provides the following methods:
//
//  Remove(), removes the event from events collection ( equivalent of Events.Remove(id) method )
//
/////////////////////////////////////////////////////////// 

exontrol.Calendar.EventOptions =
{
  /**
  * @description The date field indicates the date of the event. The date field can be any of the following:
  *
  *   {null} or {undefined}, indicates the current date and time (equivalent of Date.Now())
  *   {number}, indicates the Jan 1st of the year, such as "Jan 1st 2001" for 2001
  *   {string}, defines the date in string-format as "#MM/DD/YYYY[ HH:mm:ss]#", such as "#10/10/2011 14:48#" or string-format as "YYYY-MM-DDTHH:mm:ss.sssZ" (ISO 8601), such as "2011-10-10" (date-only format), "2011-10-10T14:48:00" (local date-time format), "2011-10-10T14:48:00Z" (UTC date-time format), or "2011-10-10T14:48:00.000+09:00" (date-time format with milliseconds and time zone offset)
  *   {Date}, indicates a javascript Date to be copied, such as "Wed, 25 Mar 2015 15:00:00 GMT" for new Date("2015-03-25T15:00:00Z")
  *
  * @type {any}
  * @example
  *
  *  null {null}, is equivalent of Date.Now()
  *  2001 {number}, is equivalent of Mon, 01 Jan 2001 00:00:00 GMT
  *  "#12/31/1971 13:00#" {string}, is equivalent of Fri, 31 Dec 1971 13:00:00 GMT
  *  new Date("2015-03-25T15:00:00Z"), is equivalent of Wed, 25 Mar 2015 15:00:00 GMT
  */
   date: null,
  /**
   * @description The selectable field indicates whether the user can select the date of the event
   * @type {boolean}
   * @example
   *
   *  false {boolean}, the date can not be selected
   *  true {boolean}, the date can be selected
  */
   selectable: true,
  /**
   * @description The key field specifies the key associated with the event.
   * @type {string}
   * @example
   *
   *  "logo" {string}, defines the event with the giving key (logo). You can use the oCalendar.Event("logo") method to request the event giving its key.
  */
   key: null,
  /**
 * @description The shape field defines the shape for the event.
 *
 * The shape field can be any of the following:
 *
 *  the shape's name within the exontrol.Shape.Calendar or exontrol.Shape namespace
 *  a CSS color
 *  a JSON string-representation of an object of exontrol.Def.Shape type, for the event
 *  an object of {normal,hover,click,disabled} type. The normal, hover, click and disabled are objects of exontrol.Def.Shape type
 *
 * @type {any}
 * @example
 *
 *  null {null}, no custom shape is applied (default object's shape may be applied)
 *  "" {string}, no custom shape is applied (no default object's shape is be applied)
 *  "red" {string}, fills the object's background in red (CSS color)
 *  '{"fillColor": "red"}' or '{"normal":{"fillColor": "red"}}' {string}, fills the object's background in red (JSON-representation of an object of exontrol.Def.Shape type)
 *  "xxx" {string}, indicates that exontrol.Shapes.Calendar.xxx or exontrol.Shapes.xxx is applied on the object's background. If the xxx field is missing, no custom shape is applied (no default object's shape is be applied)
 *  exontrol.Shapes.Button {object}, applies the "Button" shape on the object as defined into exontrol.Shapes namespace
 */
   shape: null,
  /**
 * @description The cursor field defines the mouse-cursor for the event.
 * @type {string}
 * @example
 *
 *  "pointer" {string}, The cursor is a pointer that indicates a link (typically an image of a pointing hand)
 */
   cursor: null,
  /**
  * @description The repetitive field indicates the expression to define the repetitive-event. If You specify a not empty and valid formula for the Repetitive property, the time part of the Start and End properties determines the time to start and end the repetitive event. The date part is determined by the Repetitive expression. The Repetitive property supports: 1) Value format, when using the value keyword. For instance, "weekday(value) = 1", the event occurs every Monday or 2) ICalendar format, as described in RFC 5545. For instance, "FREQ=WEEKLY;BYDAY=MO", the event occurs every Monday (requires "exontrol.icalendar.js")
  * @type {string}
  * @example
  *
  *  "" {string} or null {null}, the event is not repetitive (no effect)
  *  "0" {string}, no occurrence
  *  "1" {string}, the event occurs every day
  *  "weekday(value) = 1" {string}, the event occurs every Monday
  *  "weekday(value) in (1,2) and month(value) = 6", the event occurs every Monday and Tuesday, on June only
  *  "value in (#6/8/2012#,#6/11/2012#,#6/20/2012#)", the event occurs on 6/8/2012, 6/11/2012 and 6/20/2012
  *  "value >= #6/1/2012# and ( (value - #6/1/2012#)/86400000 mod 5 = 0)", the event starts on 6/1/2012, and shows up every 5 days
  *
  */
   repetitive: null,
  /**
  * @description The toolTip field defines the event's predefined tooltip. The event's tooltip is shown once the cursor hovers the event. The toolTip field supports ex-HTML format.
  * @type {string}
  * @example
  *
  *  null {null}, undefined {undefined} or "" {string}, no tooltip for the event is displayed
  *  "<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
  */
   toolTip: null,
  /**
  * @description The userData field stores any extra-data associated with the event
  * @type {any}
  */
   userData: undefined
}

/////////////////////////////////////////////////////////// (exontrol.Calendar.EventOptions)
//
//  The EventOptions type holds all options an event can display or own
//
//  The EventOptions type defines the following fields:
//
//    date {any}, indicates the date of the event
//    selectable {boolean}, indicates whether the date is selectable or unselectable
//    key {string}, specifies the key associated with the event
//    shape {any}, defines the shape for the event
//    cursor {string}, defines the mouse-cursor for the event
//    repetitive {string}, returns or sets the expression to define the repetitive-event
//    toolTip {string}, defines the event's predefined tooltip
//    userData {any}, associates any extra-data with the event
//
///////////////////////////////////////////////////////////

/////////////////////////////////////////////////////////// (exontrol.Shapes.Calendar)
//
// The exontrol.Shapes.Calendar namespace provides support to customize the visual appearance of different parts of the exontrol.Calendar object.
//
///////////////////////////////////////////////////////////

/**
 * @description The exontrol.Shapes.Calendar namespace provides support to customize the visual appearance of different parts of the exontrol.Calendar object.
*/
exontrol.Shapes.Calendar =
{
  select:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "RoundRect",
       fillColor: "dodgerblue",
      tfi:
      {
         fgColor: "white",
      }
    },
    /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
    hover:
    {
      tfi:
      {
         fgColor: "white"
      },
    }
  },
  highlight:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       frameDash: [1.5,1.5],
       frameColor: "black",
    }
  },
  star:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pad: 2,
       frameDash: [1.5,1.5],
       frameSize: 2,
       frameColor: "black",
       primitive: "Circle",
       fillColor: "black",
      tfi:
      {
         fgColor: "white",
         fontSize: 14,
         bold: true
      }
    }
  },
  hframe2:
  {
    /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
    hover:
    {
       pad: 2,
       frameSize: 2,
       frameColor: "black",
    }
  },
  today:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       fillColor: "rgba(0,0,0,0.10)",
       frameColor: "rgba(0,0,0,0.25)",
      tfi:
      {
         bold: true
      }
    }
  },
  gray:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
      tfi:
      {
         fgColor: "gray",
      }
    },
  },
  lightgray:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
      tfi:
      {
         fgColor: "lightgray",
      }
    },
  },
  header:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pad: [-1,1],
       padText: [-4,0],
       fillColor: "rgba(0,0,0,0.10)"
    },
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    click:
    {
       pad: [-1,1],
       padText: [-4,0],
       fillColor: "rgba(0,0,0,0.20)"
    },
   /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
/*
    hover:
    {
      pad: [-1,1],
      padText: [-4,0],
      fillColor: "rgba(0,0,0,0.10)",
    }
*/
  },
  weekend:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pattern: exontrol.PatternEnum.exPatternBDiagonal,
       patternColor: "rgba(0,0,0,0.20)"
    }
  },
  prev:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "Circle",
       fillColor: "rgb(192,192,192)",
       frameColor: "rgb(128,128,128)",
       text: "&#10094;" // HEAVY LEFT-POINTING ANGLE QUOTATION MARK ORNAMENT
    },
    /**
     * @description The click field holds an object of exontrol.Def.Shape type that's applied on the part, while it is clicked. Indicates an object of exontrol.Def.Shape type that's applied on the part, while it is clicked
     * @type {object}
    */
    click:
    {
       fillColor: "rgb(164,164,164)",
      tfi:
      {
         fgColor: "gray"
      }
    },
    /**
     * @description The disabled field holds an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled
     * @type {object}
    */
    disabled:
    {
       opacity: 0.5,
    }
  },
  next:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "Circle",
       fillColor: "rgb(192,192,192)",
       frameColor: "rgb(128,128,128)",
       text: "&#10095;" // HEAVY RIGHT-POINTING ANGLE QUOTATION MARK ORNAMENT
    },
    /**
     * @description The click field holds an object of exontrol.Def.Shape type that's applied on the part, while it is clicked. Indicates an object of exontrol.Def.Shape type that's applied on the part, while it is clicked
     * @type {object}
    */
    click:
    {
       fillColor: "rgb(164,164,164)",
      tfi:
      {
         fgColor: "gray"
      }
    },
    /**
     * @description The disabled field holds an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled
     * @type {object}
    */
    disabled:
    {
       opacity: 0.5,
    }
  }
}

/* @license Copyright (C) Exontrol. All rights reserved. */

/////////////////////////////////////////////////////////// (exontrol.Calendar)
//
//  The exontrol.Calendar class provides the following events (through oLts):
//
//     "ondatechange", notifies your application that the control's date has been changed. The ondatechange's parameter is:
//
//        oEvent {Date}, specifies the newly date that the control displays. The control's GetDate returns the same value.
//
//     "onselchanging", occurs once the control's selection is changing. The onselchanging's parameter could be any of the following:
//
//        oEvent {null}, indicates that the control has no selected dates
//        oEvent {Date}, indicates an object of Date type that defines the control's single-date selected
//        oEvent {array}, specifies an array of [Date] type that holds all selected dates within the control
//
//     "onselchange", notifies your application that the control's selection has been changed. The onselchange's parameter could be any of the following:
//
//        oEvent {null}, indicates that the control has no selected dates
//        oEvent {Date}, indicates an object of Date type that defines the control's single-date selected
//        oEvent {array}, specifies an array of [Date] type that holds all selected dates within the control
//
//     "onclick", occurs once the user clicks or double-clicks a date. The onclick's parameter is:
//
//        oEvent {object}, specifies an object of {dblClick,button,modifiers,..} type, that holds information about the object being clicked
//
//          oEvent.type {string}, specifies the type of the part being clicked
//          oEvent.date {Date}, specifies the date being clicked
//          oEvent.events {array}, holds the event being clicked, as an array of [exontrol.Calendar.Event] type
//          oEvent.dblClick {boolean}, indicates whether the user clicks or double-clicks the date
//          oEvent.button {number}, indicates which button is pressed while clicking the event as 1 (left), 2 (right) or 4 (middle)
//          oEvent.modifiers {number}, specifies a combination of 1, 2, 4 and 16 according with modifier keys (ALT, CTRL, META and SHIFT), or 0 if no modifier keys
//
//     "onanchorclick", (@since 2.2) occurs once the user clicks an anchor element (the <a id;options> ex-HTML part marks an anchor or hyperlink element). The onanchorclick's parameter is:
//
//        oEvent {object}, specifies an object of {id,options} type, that holds information about the anchor being clicked.
//
//          oEvent.id {string}, specifies null or the identifier of the anchor being clicked
//          oEvent.options {string}, specifies null or the options of the anchor being clicked
//
///////////////////////////////////////////////////////////

/////////////////////////////////////////////////////////// (exontrol.Def.Calendar)
//
// The exontrol.Def.Calendar namespace provides definitions for different objects, primitives, objects of exontrol.Calendar object
//
//  The exontrol.Def.Calendar namespace provides the following fields:
//
//   tfi {(string|object)}, holds the font attributes for captions within the control. The tfi field can be defined using a string representation such as &quot;b monospace 16&quot; or as an object such as {bold: true, fontName: &quot;monospace&quot;, 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.
//   readOnly {boolean}, indicates whether the control is read-only (the user can't select new dates, but can browse for any date, @since 1.8).
//   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.
//   events {object}, defines the events of the control
//
///////////////////////////////////////////////////////////

/**
 * @description The exontrol.Def.Calendar namespace provides definitions for different objects, primitives, objects of exontrol.Calendar object.
*/
exontrol.Def.Calendar =
{
  /**
  * @description The tfi field applies font attributes to 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}.
  *
  * 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" {string}, defines Monospace font of 16px height, bold
  *   {bold: true, fontName: "monospace", fontSize: 16} {object}, defines Monospace font of 16px height, bold
  */
   tfi: null,
  /**
  * @description The locale field specifies the language whose formatting conventions should be used to customize the calendar. A string with a BCP 47 language tag.
  * @type {string}
  * @example
  *
  *   null {null}, indicates that the browser's UI language is used.
  *   "de" {string}, defines German locale
  *   "ro" {string}, defines Romanian locale
  */
   locale: null,
  /**
   * @description The mode field specifies the orientation the calendar displays the days of the weeks.
   *
   * The exontrol.Calendar.ModeEnum type supports the following values:
   *
   *  exVertical(0), specifies that the days of the week are vertically arranged
   *  exHorizontal(1), specifies that the days of the week are horizontally arranged
   *
   * @type {exontrol.Calendar.ModeEnum}
   * @example
   *
   *  0 or exontrol.Calendar.ModeEnum.exVertical {number}, shows vertically the week days
   *  1 or exontrol.Calendar.ModeEnum.exHorizontal {number}, shows horizontally the week days
  */
   mode: exontrol.Calendar.ModeEnum.exHorizontal,
  /**
   * @description The flow field determines whether the months gets arranged from left to right or top to bottom.
   *
   * The exontrol.Calendar.FlowEnum type supports the following values:
   *
   *  exLeftToRight(0), indicates that the next month gets arranged to the right of the current month
   *  exTopToBottom(1), indicates that the next month gets arranged to the bottom of the current month
   *
   * @type {exontrol.Calendar.FlowEnum}
   * @example
   *
   *  0 or exontrol.Calendar.FlowEnum.exLeftToRight {number}, arranges months from left to right
   *  1 or exontrol.Calendar.FlowEnum.exTopToBottom {number}, arranges months from top to bottom
  */
   flow: exontrol.Calendar.FlowEnum.exLeftToRight,
  /**
   * @description The date field specifies the calendar's browsing date as string in format "#MM/DD/YYYY#"
   * @type {string}
   * @example
   *
   *  null {null}, browses today date
   *  "#12/31/1971#" {string}, browses December 31, 1971
  */
   date: null,
  /**
  * @description The autoSize field determines whether the size of the calendar's date is fixed, or relative to the current font or client area.
  *
  * The exontrol.Calendar.AutoSizeEnum type defines the following values:
  *
  *   exFontSize(-1), indicates that the size of the calendar's date is automatically computed based on the current font
  *   exFixedSize(0), specifies that the size of the calendar's date is fixed. The dayFixedWidth / dayFixedHeight specifies the size of the calendar's date while autoSize property is exontrol.Calendar.AutoSizeEnum.exFixedSize
  *   exFitClient(1), indicates that the size of the calendar's date is computed so entire calendar fits the control's client area
  *
  * @type {exontrol.Calendar.AutoSizeEnum}
  * @example
  *
  *   -1 or exontrol.Calendar.AutoSizeEnum.exFontSize {number}, defines the size of the calendar's date based on the current font.
  *   1 or exontrol.Calendar.AutoSizeEnum.exFitClient {number}, resizes the calendar's date to ensure all months fit the control's client area
  */
   autoSize: exontrol.Calendar.AutoSizeEnum.exFontSize,
  /**
  * @description The smoothSel field defines the time in ms the calendar's selection goes from one state to another.
  * @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.
  */
   smoothSel: 125,
  /**
  * @description The smoothScroll field defines the time in ms the calendar's date scrolls to another.
  * @type {number}
  * @example
  *
  *   0 {number}, no smooth changes once the control goes from a layout to another
  *   250 {number}, specifies that a smooth-transition is performed from a layout to another for 250 ms.
  */
   smoothScroll: 250,
  /**
  * @description The locked field indicates whether the control is locked(protected) or unlocked
  * @type {boolean}
  * @example
  *
  *   false {boolean}, unlocks the control (can select any date)
  *   true {boolean}, locks the control (can't select any date)
  */
   locked: false,
  /**
   * @description The readOnly field indicates whether the control is read-only (the user can't select new dates, but can browse for any date)
   * @type {boolean}
   * @since 1.8
   * @example
   *
   *   false {boolean}, the user can select new dates
   *   true {boolean}, the user can not select dates
  */
   readOnly: false,
  /**
   * @description The selection field specifies the selected date(s). Indicates the control's selection, as one of the following:
   *
   *  {null}, clears the control's selection
   *  {string}, defines the date to select in string-format as "#MM/DD/YYYY[ HH:mm:ss]#" or string-format as "YYYY-MM-DDTHH:mm:ss.sssZ" (ISO 8601), such as "2011-10-10" (date-only format), "2011-10-10T14:48:00" (local date-time format), "2011-10-10T14:48:00Z" (UTC date-time format), or "2011-10-10T14:48:00.000+09:00" (date-time format with milliseconds and time zone offset) (since 1.3)
   *  {number}, integer value representing the year of the date to be selected. For instance, 2022 goes for "Jan 1st, 2022"
   *  {Date}, indicates a JavaScript date to be selected
   *  {array}, indicates a collection of dates to be selected, as an array of [date] type, where date could be null, string, number or a Date expression
   *
   * @type {any}
   * @example
   *
   *  null {null}, clears the control's selection
   *  [null] {array}, selects today
   *  "#1/15/2022#" or "2022-1-15" {string}, selects the specified date
   *  2022 {number}, selects "Jan 1st, 2022"
   *  Date.Today().NextDay(1) {Date}, selects tomorrow
   *  Calendar.Collect(Date.Today(), null, Calendar.CollectEnum.exWeek) {Date}, selects the current week (in case the control allows multiple selection, else it selects the first day of the current week)
   *  [null,Date.Today().NextDay(1)] {array}, selects today and tommorow date
   *  ["#1/13/2022#","#1/15/2022#"] {array}, selects Jan 13 and 15 of 2022
  */
   selection: null,
  /**
   * @description The singleSel field specifies whether the control supports single, multiple, toggle selection.
   *
   * The exontrol.Calendar.SingleSelEnum type supports the following flags:
   *
   *  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 date only
   *  exToggleSel(4), specifies that the date's selection state is toggled once the user clicks a date.
   *  exDisableCtrlSel(8), disables toggling the date's selection state when user clicks a date, while CTRL modifier key is pressed.
   *  exDisableShiftSel(16), disables selecting dates using the SHIFT key.
   *  exDisableDrag(32), disables selecting dates by drag.
   *
   * @type {exontrol.Calendar.SingleSelEnum}
   * @example
   *
   *  0 or exontrol.Calendar.SingleSelEnum.exDisableSel {number}, disables selecting any date
   *  3 or exontrol.Calendar.SingleSelEnum.exSingleSel | exontrol.Calendar.SingleSelEnum.exEnableSel {number}, enables control's single selection, so only a single date can be selected
   *  6 or exontrol.Calendar.SingleSelEnum.exToggleSel | exontrol.Calendar.SingleSelEnum.exSingleSel {number}, enables control's single and toggle selection, which means that once a date is selected it gets unselected once it is clicked, or reverse, and only a single-date can be selected at once.
  */
   singleSel: exontrol.Calendar.SingleSelEnum.exEnableSel,
  /**
   * @description The allowSwitchView field specifies whether the user can switch the view (month or year).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, disables month or year view
   *  true {boolean}, enables month or year view
  */
   allowSwitchView: true,
  /**
   * @description The allowScrollByDrag field specifies whether the user can scroll the control by drag.
   * @type {boolean}
   * @example
   *
   *  false {boolean}, disables scrolling the control while user drags outside
   *  true {boolean}, the user can scrolls the control by drag (click a month area where no dates is displayed and drag in any direction to get control scrolled)
  */
   allowScrollByDrag: true,
  /**
   * @description The padCal field specifies the padding to display the calendar. Defines a numeric, string or array value that determines the padding to be applied.
   * @type {(number|string|array)}
   * @example
   *
   *   null {null}, indicates that the default-padding field is used (4)
   *   0 {number}, indicates no padding
   *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
   *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
  */
   padCal: 4,
  /**
   * @description The alignCal field aligns the calendar relative to the canvas.
   *
   * The exontrol.AlignEnum type supports the following values:
   *
   *  exAlignTop (0x00), justifies the object to the top of the rectangle
   *  exAlignLeft (0x00), aligns object to the left
   *  exAlignCenter (0x01), centers object horizontally in the rectangle
   *  exAlignRight (0x02), aligns object to the right
   *  exAlignVCenter (0x04), centers object vertically
   *  exAlignBottom (0x08), justifies the object to the bottom of the rectangle
   *
   * @type {exontrol.AlignEnum}
   * @example
   *
   *  0 or exontrol.AlignEnum.exAlignTop | exontrol.AlignEnum.exAlignLeft {number}, aligns the calendar to the top-left corner
   *  5 or exontrol.AlignEnum.exAlignCenter | exontrol.AlignEnum.exAlignVCenter {number}, centers the calendar
  */
   alignCal: exontrol.AlignEnum.exAlignCenter | exontrol.AlignEnum.exAlignVCenter,
  /**
  * @description The wheelChange field specifies the amount the calendar scrolls when the user rolls the mouse wheel.
  * @type {number}
  * @example
  *
  *   0 {number}, locks any action the mouse's wheel performs
  *   1 {number}, advances one month back or forward once the user rotates the mouse wheel
  */
   wheelChange: 1,
  /**
  * @description The minMonthX field specifies the minimum number of months horizontally displayed.
  *
  * The minMonthX and maxMonthX properties determines the number of months horizontally displayed. The number of months horizontally displayed depends on the month's size and the canvas's size. If the minMonthX and maxMonthX properties are equal it specifies exactly the months horizontally displayed.
  *
  * @type {number}
  * @example
  *
  *   2 {number}, indicates that the calendar displays minimum two months
  */
   minMonthX: 1,
  /**
  * @description The maxMonthX field specifies the maximum number of months horizontally displayed.
  *
  * The minMonthX and maxMonthX properties determines the number of months horizontally displayed. The number of months horizontally displayed depends on the month's size and the canvas's size. If the minMonthX and maxMonthX properties are equal it specifies exactly the months horizontally displayed.
  *
  * @type {number}
  * @example
  *
  *   6 {number}, indicates that the calendar displays maximum six months.
  */
   maxMonthX: 6,
  /**
  * @description The minMonthY field specifies the minimum number of months vertically displayed.
  *
  * The minMonthY and maxMonthY properties determines the number of months vertically displayed. The number of months vertically displayed depends on the month's size and the canvas's size. If the minMonthY and maxMonthY properties are equal it specifies exactly the months vertically displayed.
  *
  * @type {number}
  * @example
  *
  *   2 {number}, indicates that the calendar displays minimum two months
  */
   minMonthY: 1,
  /**
  * @description The maxMonthY field specifies the maximum number of months vertically displayed.
  *
  * The minMonthY and maxMonthY properties determines the number of months vertically displayed. The number of months vertically displayed depends on the month's size and the canvas's size. If the minMonthY and maxMonthY properties are equal it specifies exactly the months vertically displayed.
  *
  * @type {number}
  * @example
  *
  *   6 {number}, indicates that the calendar displays maximum six months.
  */
   maxMonthY: 2,
  /**
   * @description The padding field specifies the padding to be applied on dates of the calendar. Defines a numeric, string or array value that determines the padding to be applied.
   * @type {(number|string|array)}
   * @example
   *
   *   null {null}, indicates that the default-padding field is used ([4,2])
   *   0 {number}, indicates no padding
   *   "8,4" {string}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
   *   [8,4] {array}, increases the object's width with 2 * 8-pixels and object's height with 2 * 4-pixels
  */
   pad: [4,2],
  /**
   * @description The dayLabel field indicates a ex-HTML string that can include expression fields (<%...%>) to display the date while the calendar is in day-view.
   *
   * Defines a ex-HTML string that can include expression fields (<%...%>) to display the date while the calendar is in day-view.
   *
   * The dayLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "<%d%>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31),
   *  "<%dd%>" {string}, displays day of the month in two numeric digits (01 to 31)
   *  "<%d%>\n<font ;8><fgcolor gray><%y%></fgcolor>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31) on the first line, and on the second line displays the number of the day of the year (1 to 366) in gray
  */
   dayLabel: "<%d%>",
  /**
   * @description The dayAlign field aligns the date's label, while the calendar is in day-view. A combination of one or more exontrol.DrawTextFormatEnum flags that defines the way the date's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   dayAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextNoClip,
  /**
   * @description The dayFixedWidth field defines the width of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
   *
   * The dayFixedWidth field has effect only if the autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize. The dayFixedWidth property does not include the date's padding.
   *
   * @type {number}
   * @example
   *
   *  24 {number}, defines the date's width to 24-pixels
  */
   dayFixedWidth: 24,
  /**
   * @description The dayFixedHeight field defines the height of the calendar's date when autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize.
   *
   * The dayFixedHeight field has effect only if the autoSize is exontrol.Calendar.AutoSizeEnum.exFixedSize. The dayFixedHeight property does not include the date's padding.
   *
   * @type {number}
   * @example
   *
   *  24 {number}, defines the date's height to 24-pixels
   */
   dayFixedHeight: 24,
  /**
   * @description The dayWeekHeader field specifies whether the calendar shows the header to display the days of the week (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the header that displays the days of the week (day-view only).
   *  true {boolean}, shows the header that displays the days of the week (day-view only).
  */
   dayWeekHeader: true,
  /**
   * @description The dayWeekLabel field defines the ex-HTML label to show the days of the week into the calendar's header (day-view only). Specifies the ex-HTML label to show the days of the week into the calendar's header (day-view only).
   *
   * The dayWeekLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%d2%>" {string}, displays first two letters of the weekday (Su to Sa)
   *  "<b><%d3%></b>" {string}, displays first thee letters of the weekday (Sun to Sat) in bold
  */
   dayWeekLabel: "<%d2%>",
  /**
   * @description The dayWeekNoHeader field specifies whether the calendar shows the header to display week-number (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the calendar's header that displays the week-number
   *  true {boolean}, shows the calendar's header that displays the week-number
  */
   dayWeekNoHeader: true,
  /**
   * @description The dayWeekNoLabel field defines the ex-HTML label to show the week-number into the calendar's header (day-view only). Specifies the ex-HTML label to show the week-number into the calendar's header (day-view only).
   *
   * The dayWeekNoLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekNoLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%ww%>" {string}, displays the week of the year (1 to 53)
   *  "<fgcolor red><%ww%></fgcolor>" {string}, displays the week of the year (1 to 53) in red
  */
   dayWeekNoLabel: "<%ww%>",
  /**
   * @description The dayMonthHeader field specifies whether the calendar shows the header to display month's name (day-view only).
   * @type {boolean}
   * @example
   *
   *  false {boolean}, hides the calendar's header (month's name)
   *  true {boolean}, shows the calendar's header (month's name)
  */
   dayMonthHeader: true,
  /**
   * @description The dayMonthLabel field defines the ex-HTML label to show the month-name into the calendar's header (day-view only). Specifies the ex-HTML label to show the month-name into the calendar's header (day-view only).
   *
   * The dayMonthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayMonthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%mmm%>" {string}, displays three-letters of the month
   *  "<%mmmm%> <%yyyy%>" {string}, displays the full month and year
   *  "<b><%mmm%></b><r><fgcolor gray><font ;8><off 6><%yyyy%>" {string}, displays an combined ex-HTML format
  */
   dayMonthLabel: "<%mmmm%> <%yyyy%>",
  /**
   * @description The dayMonthAlign field aligns the month's label, while the calendar is in day-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the date's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   dayMonthAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextNoClip,
  /**
   * @description The dayNonMonth field specifies whether the calendar displays the dates that are not part of the current month.
   * @type {number}
   * @example
   *
   *  false {boolean}, hides the dates that are not part of the current month.
   *  true {boolean}, shows the dates that are not part of the current month.
  */
   dayNonMonth: true,
  /**
   * @description The dayNonMonthLabel field defines the ex-HTML label to show the dates that are not part of the current month (day-view only). Specifies the ex-HTML label to show the dates that are not part of the current month (day-view only).
   *
   * The dayNonMonthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayNonMonthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%d%>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31)
   *  "<fgcolor lightgray><%d%></fgcolor>" {string}, displays the day of the month in one or two numeric digits, as needed (1 to 31) in gray
  */
   dayNonMonthLabel: "<%d%>",
  /**
   * @description The dayWeekAllLabel field 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). Specifies 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).
   *
   * The dayWeekAllLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, dayWeekAllLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<b><%mr%>" {string}, displays month of the year in Roman numerals, as needed (I to XII) in bold
  */
   dayWeekAllLabel: "",
  /**
   * @description The monthLabel field specifies the ex-HTML string that can include expression fields (<%...%>) to display the month while the calendar is in month-view. Defines the ex-HTML string that can include expression fields (<%...%>) to display the month while the calendar is in month-view.
   *
   * The monthLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, monthLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%mmm%>" {string}, displays first three letters of the month (Jan to Dec)
  */
   monthLabel: "<%mmm%>",
  /**
   * @description The monthAlign field aligns the month's label, while the calendar is in month-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the month's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   monthAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter | exontrol.DrawTextFormatEnum.exTextWordEllipsis,
  /**
   * @description The monthYearAlign field aligns the year's label, while the calendar is in month-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the year's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   monthYearAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The yearLabel field specifies the ex-HTML string that can include expression fields (<%...%>) to display the year while the calendar is in year-view. Defines the ex-HTML string that can include expression fields (<%...%>) to display the year while the calendar is in year-view.
   *
   * The yearLabel property can include any of the following fields:
   *
   *  "<%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
   *
   * Also, yearLabel property supports ex-HTML tags as follows:
   *
   *   "<b>text</b>", displays the text in bold.
   *   "<i>text</i>", displays the text in italics.
   *   "<u>text</u>", underlines the text.
   *   "<s>text</s>", strike-through text
   *   "<a [id][;options]>text</a>", displays an anchor element that can be clicked
   *   "<font [family][;size]>text</font>", displays portions of text with a different font and/or different size.
   *   "<fgcolor color>text</fgcolor>", displays text with a specified foreground color.
   *   "<bgcolor color>text</bgcolor>", displays text with a specified background color.
   *   "<br>", defines a forced line-break
   *   "<r>", right aligns the text
   *   "<c>", centers the text
   *   "<img>key[:width]</img>", displays a custom-sized picture into the text. The key defines the name of the picture/image to be shown. The image can be added using the exontrol.HTMLPicture.Add() method.
   *   & glyph characters as "&amp;" ( & ), "&lt;" ( < ), "&gt;" ( > ),  "&qout;" ( quote character ) and "&#number;" ( the character with specified code ). For instance, "&#8364;" displays the EURO sign
   *   "<off offset>text</off>", defines the vertical offset to display the text.
   *   "<gra color[;mode[;blend]]>text</gra>", shows the text in gradient
   *   "<out color[;width]>text</out>", shows the text with outlined characters
   *   "<sha color[;width[;offset]]>text</sha>", shows the text with a shadow
   *
   * @type {string}
   * @example
   *
   *  "" {string}, displays nothing
   *  "<%yyyy%>" {string}, displays the year with four digits
  */
   yearLabel: "<%yyyy%>",
  /**
   * @description The yearAlign field aligns the year's label, while the calendar is in year-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the year's label is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   yearAlign: exontrol.DrawTextFormatEnum.exTextAlignCenter | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The yearRangeAlign field aligns the label that displays the range of years, while the calendar is in year-view. Indicates a exontrol.DrawTextFormatEnum value that defines the way the label that displays the range of years is being displayed.
   *
   * The exontrol.DrawTextFormatEnum type support the following flags:
   *
   *   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 <fgcolor> and </bgcolor> 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 label
   *   32 or exontrol.DrawTextFormatEnum.exTextSingleLine {number}, defines a single-line label
   *   0x2A or exontrol.DrawTextFormatEnum.exTextSingleLine | exontrol.DrawTextFormatEnum.exTextAlignRight | exontrol.DrawTextFormatEnum.exTextAlignBottom {number}, defines a single-line label right/bottom-aligned
  */
   yearRangeAlign: exontrol.DrawTextFormatEnum.exTextAlignLeft | exontrol.DrawTextFormatEnum.exTextAlignVCenter,
  /**
   * @description The shapes field defines the shapes each part of the control can display. The shapes field customizes the control's visual appearance.
   *
   * The format of shapes property is:
   *
   *  "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": &quot;RoundRect&quot;,&quot;fillColor&quot;:&quot;black&quot;,&quot;tfi&quot;: {&quot;fgColor&quot;: "white"}}}')
   *    specifies the name of the field within the exontrol.Shapes.Calendar object (while it starts with a lowercase letter, such as today which refers to exontrol.Shapes.Calendar.today 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 bellow)
   *
   * The shapes property supports any of the following parts:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @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(dt)", "#FF0000(dt)", "rgb(255,0,0)(dt)", "rgba(255,0,0,1)(dt)" {string}, shows "today" in red
   *  '{"normal":{"fillColor":"lightgray","primitive":"Circle"},"hover":{"frameColor":"black"}}(d)' {string}, shows all-days within a circle, and draws a black-frame when hovers it
   *  "xxx(d),yyy(d,m),zzz(y)"  {string}, specifies that the exontrol.Shapes.Calendar.xxx combined with exontrol.Shapes.Calendar.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.Calendar.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.Calendar.zzz object defines the visual appearance of "y" part of the control
  */
   shapes: "hframe2(d,dnm,m,y),header(dmh,mh,yh),today(dt,mt,yt),gray(dw,dwn,dwnn),lightgray(dnm),select(ds,ms,ys),weekend(de),prev(p),next(n)",
  /**
   * @description The hlShapes field defines the shape(s) to be applied on a part of the control, when it requires to be highlighted
   *
   * The format of hlShapes property is:
   *
   *  "shape(part),shape(part),..."
   *
   * where:
   *
   *  "shape", indicates the name of the sub-object within the exontrol.Shapes.Calendar or exontrol.Shapes namespace to be applied on the part (also it can be a CSS color or a JSON string-representation of a {normal,disabled,hover,click} or exontrol.Def.Shape object),
   *  "part", defines the name of the part the shape is applied on (as defined bellow)
   *
   * The hlShapes property supports any of the following parts:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @type {string}
   * @example
   *
   *  null {null}, specifies the default visual appearance
   *  "" {string}, no shape (no visual appearance is applied to any part of the control)
   *  "star(d,dnm,dwa)" {string}, indicates that a exontrol.Shapes.Calendar.star object is applied on "d", "dnm" and "dwa" parts of the control.
   *  "xxx(d),yyy(d,m),zzz(y)" {string}, specifies that the exontrol.Shapes.Calendar.xxx combined with exontrol.Shapes.Calendar.yyy object defines the visual appearance of "d" part of the control, exontrol.Shapes.Calendar.yyy object defines the visual appearance of "m" part of the control and exontrol.Shapes.Calendar.zzz object defines the visual appearance of "y" part of the control
   */
   hlShapes: "highlight(m,dm,y),star(d,dnm,dwa)",
  /**
   * @description The cursors field specifies the mouse cursor to be displayed when pointing over a part of the control.
   *
   * The format of cursors property is:
   *
   *  "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 bellow)
   *
   * The "part" can be any of the following:
   *
   *  "p" (prev), defines the prev button (available for any view)
   *  "n" (next), defines the next button (available for any view)
   *  "anchor" (hyperlink), defines the mouse-cursor when the mouse pointer hovers the anchor (the <a> ex-HTML part marks an anchor or hyperlink element) (@since 2.2)
   *
   * The following parts are available while the control displays the day-view:
   *
   *  "da" (day-all), indicates all objects of the month.
   *  "dmh" (day-month-header) object that indicates the header that displays the month
   *  "dm" (days-month) specifies all days displayed in the current month ( it can include also non-month days as well )
   *  "d" (day), specifies a day of the current month
   *  "dnm" (day-non-month), specifies a day that is not part of the current month, but it is still displayed
   *  "dt" (today), specifies today in the current month
   *  "ds" (day-select), indicates a selected date
   *  "de" (week-end), specifies a day of weekend
   *
   *  "dwa" (day-weeks-all) indicates the top-left corner object, when the week-header and week-number headers are visible
   *  "dwh" (day-week-header) indicates the header that shows the days of the week
   *  "dw" (day-week) specifies a day into the week-header
   *  "dwnh" (day-week-number-header) indicates the header that displays the week-numbers
   *  "dwn" (day-week-number) specifies the week-number
   *  "dwnn" (day-week-number-non-month) specifies the week-number that is not part of the current month
   *
   * The following parts are available while the control displays the month-view:
   *
   *  "ma" (month-all) specifies the area to display the entire year
   *  "mh" (month-header) indicates the header for month-view (it displays the year)
   *  "mm" (month-month) indicates the portion of the layout that displays the months of the year (excludes its header)
   *  "m" (month) specifies a single month within the month-view
   *  "mt" (month-today), indicates the current month (the month that contains today)
   *  "ms" (month-select), indicates a month that contains a selected date
   *
   * The following parts are available while the control displays the year-view:
   *
   *  "ya" (year-all) that specifies the area to display the entire layout
   *  "yh" (year-header) that indicates the header for year-view (it displays the range of years)
   *  "yy" (year-years) that indicates the portion of the layout that displays the years (excludes its header)
   *  "y" (year) that specifies a single year within the year-view
   *  "yt" (year-today), specifies the year of today
   *  "ys" (year-select), indicates a year that contains a selected date
   *
   * @type {string}
   * @example
   *
   *   "" {string}, no mouse cursor support
   *   "pointer(d,p,n)" {string}, indicates that the "pointer" mouse cursor is shown once the cursor hovers the "d", "p" or "n" parts of the control
  */
   cursors: "pointer(p,n,anchor)",
  /**
   * @description The toolTipDelay field specifies how long the mouse pointer must point to an object before the tool tip appears
   * @type {number}
   * @example
   *
   *   0 {number}, the tooltip is shown "immediately"
   *   128 {number}, the tooltip is displayed in 128 ms.
  */
   toolTipDelay: 500,
  /**
   * @description The toolTipPopDelay field specifies the period in ms of time the tool top remains visible if the mouse pointer is stationary within a control
   * @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: 5000,
  /**
   * @description The toolTipWidth field indicates the max-width of the control's tooltip (in pixels)
   * @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: -1,
  /**
   * @description The events field defines the events within the control. The events field can be any of the following:
   *
   *  {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 = [{date: "#1/1/2001#", shape: "red"}], {array} defines a single event
   *  Events =
   *  {
   *    "E1":
   *    {
   *      date: "#1/1/2001#",
   *      shape: "rgba(255,0,0,0.5)"
   *    },
   *    "E2":
   *    {
   *      date: "#1/1/2001#",
   *      shape: "rgba(255,255,0,0.5)"
   *    }
   *  }, {object} defines two events "E1" and "E2"
   *
  */
   events: null
}

/////////////////////////////////////////////////////////// (exontrol.Calendar.Events)
//
// The Events object holds a collection of Event type (event of the control)
//
// The Events object provides the following methods:
//
//  Add(oEventOpts) {Event}, creates and adds a new event into the control
//  Count/GetCount() {number}, returns the number of events within the collection.
//  Item(id) {Event}, gets the event giving its index, identifier/key or reference
//  Remove(id), removes the event giving its index, identifier/key or reference
//  Clear(), removes all events of the control
//
/////////////////////////////////////////////////////////// 

/////////////////////////////////////////////////////////// (exontrol.Calendar.Event)
//
// The Event object holds event objects of the control. The Add(oEventOpts) method of exontrol.Calendar.Events object creates and adds a new event into the control.
//
// The Event object provides the following methods:
//
//  Options/GetOptions()/SetOptions(value) {exontrol.Calendar.EventOptions}, indicates the event's options (at once) such as visibility, position and so on
//  Index/GetIndex() {number}, returns the index of the event (0-based)
//  Date/GetDate()/SetDate(value) {any}, indicates the date of the event
//  Key/GetKey()/SetKey(value) {any}, specifies the event's key (the Events.Item(key) requests an event by its index, identifier/key or reference)
//  Selectable/GetSelectable()/SetSelectable(value) {boolean}, specifies whether the user can select the date
//  Shape/GetShape()/SetShape(value) {any}, the shape for the event.
//  Cursor/GetCursor()/SetCursor(value) {string}, the mouse cursor for the event.
//  Repetitive/GetRepetitive()/SetRepetitive(value) {string}, returns or sets the expression to define the repetitive-event
//  ToolTip/GetToolTip()/SetToolTip(value) {string}, defines the event's predefined tooltip
//  UserData/GetUserData()/SetUserData(value) {any}, associates any extra-data with the event
//
// Also, the exontrol.Calendar.Event object provides the following methods:
//
//  Remove(), removes the event from events collection ( equivalent of Events.Remove(id) method )
//
/////////////////////////////////////////////////////////// 

exontrol.Calendar.EventOptions =
{
  /**
  * @description The date field indicates the date of the event. The date field can be any of the following:
  *
  *   {null} or {undefined}, indicates the current date and time (equivalent of Date.Now())
  *   {number}, indicates the Jan 1st of the year, such as "Jan 1st 2001" for 2001
  *   {string}, defines the date in string-format as "#MM/DD/YYYY[ HH:mm:ss]#", such as "#10/10/2011 14:48#" or string-format as "YYYY-MM-DDTHH:mm:ss.sssZ" (ISO 8601), such as "2011-10-10" (date-only format), "2011-10-10T14:48:00" (local date-time format), "2011-10-10T14:48:00Z" (UTC date-time format), or "2011-10-10T14:48:00.000+09:00" (date-time format with milliseconds and time zone offset)
  *   {Date}, indicates a javascript Date to be copied, such as "Wed, 25 Mar 2015 15:00:00 GMT" for new Date("2015-03-25T15:00:00Z")
  *
  * @type {any}
  * @example
  *
  *  null {null}, is equivalent of Date.Now()
  *  2001 {number}, is equivalent of Mon, 01 Jan 2001 00:00:00 GMT
  *  "#12/31/1971 13:00#" {string}, is equivalent of Fri, 31 Dec 1971 13:00:00 GMT
  *  new Date("2015-03-25T15:00:00Z"), is equivalent of Wed, 25 Mar 2015 15:00:00 GMT
  */
   date: null,
  /**
   * @description The selectable field indicates whether the user can select the date of the event
   * @type {boolean}
   * @example
   *
   *  false {boolean}, the date can not be selected
   *  true {boolean}, the date can be selected
  */
   selectable: true,
  /**
   * @description The key field specifies the key associated with the event.
   * @type {string}
   * @example
   *
   *  "logo" {string}, defines the event with the giving key (logo). You can use the oCalendar.Event("logo") method to request the event giving its key.
  */
   key: null,
  /**
 * @description The shape field defines the shape for the event.
 *
 * The shape field can be any of the following:
 *
 *  the shape's name within the exontrol.Shape.Calendar or exontrol.Shape namespace
 *  a CSS color
 *  a JSON string-representation of an object of exontrol.Def.Shape type, for the event
 *  an object of {normal,hover,click,disabled} type. The normal, hover, click and disabled are objects of exontrol.Def.Shape type
 *
 * @type {any}
 * @example
 *
 *  null {null}, no custom shape is applied (default object's shape may be applied)
 *  "" {string}, no custom shape is applied (no default object's shape is be applied)
 *  "red" {string}, fills the object's background in red (CSS color)
 *  '{"fillColor": "red"}' or '{"normal":{"fillColor": "red"}}' {string}, fills the object's background in red (JSON-representation of an object of exontrol.Def.Shape type)
 *  "xxx" {string}, indicates that exontrol.Shapes.Calendar.xxx or exontrol.Shapes.xxx is applied on the object's background. If the xxx field is missing, no custom shape is applied (no default object's shape is be applied)
 *  exontrol.Shapes.Button {object}, applies the "Button" shape on the object as defined into exontrol.Shapes namespace
 */
   shape: null,
  /**
 * @description The cursor field defines the mouse-cursor for the event.
 * @type {string}
 * @example
 *
 *  "pointer" {string}, The cursor is a pointer that indicates a link (typically an image of a pointing hand)
 */
   cursor: null,
  /**
  * @description The repetitive field indicates the expression to define the repetitive-event. If You specify a not empty and valid formula for the Repetitive property, the time part of the Start and End properties determines the time to start and end the repetitive event. The date part is determined by the Repetitive expression. The Repetitive property supports: 1) Value format, when using the value keyword. For instance, "weekday(value) = 1", the event occurs every Monday or 2) ICalendar format, as described in RFC 5545. For instance, "FREQ=WEEKLY;BYDAY=MO", the event occurs every Monday (requires "exontrol.icalendar.js")
  * @type {string}
  * @example
  *
  *  "" {string} or null {null}, the event is not repetitive (no effect)
  *  "0" {string}, no occurrence
  *  "1" {string}, the event occurs every day
  *  "weekday(value) = 1" {string}, the event occurs every Monday
  *  "weekday(value) in (1,2) and month(value) = 6", the event occurs every Monday and Tuesday, on June only
  *  "value in (#6/8/2012#,#6/11/2012#,#6/20/2012#)", the event occurs on 6/8/2012, 6/11/2012 and 6/20/2012
  *  "value >= #6/1/2012# and ( (value - #6/1/2012#)/86400000 mod 5 = 0)", the event starts on 6/1/2012, and shows up every 5 days
  *
  */
   repetitive: null,
  /**
  * @description The toolTip field defines the event's predefined tooltip. The event's tooltip is shown once the cursor hovers the event. The toolTip field supports ex-HTML format.
  * @type {string}
  * @example
  *
  *  null {null}, undefined {undefined} or "" {string}, no tooltip for the event is displayed
  *  "<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
  */
   toolTip: null,
  /**
  * @description The userData field stores any extra-data associated with the event
  * @type {any}
  */
   userData: undefined
}

/////////////////////////////////////////////////////////// (exontrol.Calendar.EventOptions)
//
//  The EventOptions type holds all options an event can display or own
//
//  The EventOptions type defines the following fields:
//
//    date {any}, indicates the date of the event
//    selectable {boolean}, indicates whether the date is selectable or unselectable
//    key {string}, specifies the key associated with the event
//    shape {any}, defines the shape for the event
//    cursor {string}, defines the mouse-cursor for the event
//    repetitive {string}, returns or sets the expression to define the repetitive-event
//    toolTip {string}, defines the event's predefined tooltip
//    userData {any}, associates any extra-data with the event
//
///////////////////////////////////////////////////////////

/////////////////////////////////////////////////////////// (exontrol.Shapes.Calendar)
//
// The exontrol.Shapes.Calendar namespace provides support to customize the visual appearance of different parts of the exontrol.Calendar object.
//
///////////////////////////////////////////////////////////

/**
 * @description The exontrol.Shapes.Calendar namespace provides support to customize the visual appearance of different parts of the exontrol.Calendar object.
*/
exontrol.Shapes.Calendar =
{
  select:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "RoundRect",
       fillColor: "dodgerblue",
      tfi:
      {
         fgColor: "white",
      }
    },
    /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
    hover:
    {
      tfi:
      {
         fgColor: "white"
      },
    }
  },
  highlight:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       frameDash: [1.5,1.5],
       frameColor: "black",
    }
  },
  star:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pad: 2,
       frameDash: [1.5,1.5],
       frameSize: 2,
       frameColor: "black",
       primitive: "Circle",
       fillColor: "black",
      tfi:
      {
         fgColor: "white",
         fontSize: 14,
         bold: true
      }
    }
  },
  hframe2:
  {
    /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
    hover:
    {
       pad: 2,
       frameSize: 2,
       frameColor: "black",
    }
  },
  today:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       fillColor: "rgba(0,0,0,0.10)",
       frameColor: "rgba(0,0,0,0.25)",
      tfi:
      {
         bold: true
      }
    }
  },
  gray:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
      tfi:
      {
         fgColor: "gray",
      }
    },
  },
  lightgray:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
      tfi:
      {
         fgColor: "lightgray",
      }
    },
  },
  header:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pad: [-1,1],
       padText: [-4,0],
       fillColor: "rgba(0,0,0,0.10)"
    },
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    click:
    {
       pad: [-1,1],
       padText: [-4,0],
       fillColor: "rgba(0,0,0,0.20)"
    },
   /**
     * @description The hover field holds an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the cursor hovers it.
     * @type {object}
    */
/*
    hover:
    {
      pad: [-1,1],
      padText: [-4,0],
      fillColor: "rgba(0,0,0,0.10)",
    }
*/
  },
  weekend:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       pattern: exontrol.PatternEnum.exPatternBDiagonal,
       patternColor: "rgba(0,0,0,0.20)"
    }
  },
  prev:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "Circle",
       fillColor: "rgb(192,192,192)",
       frameColor: "rgb(128,128,128)",
       text: "&#10094;" // HEAVY LEFT-POINTING ANGLE QUOTATION MARK ORNAMENT
    },
    /**
     * @description The click field holds an object of exontrol.Def.Shape type that's applied on the part, while it is clicked. Indicates an object of exontrol.Def.Shape type that's applied on the part, while it is clicked
     * @type {object}
    */
    click:
    {
       fillColor: "rgb(164,164,164)",
      tfi:
      {
         fgColor: "gray"
      }
    },
    /**
     * @description The disabled field holds an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled
     * @type {object}
    */
    disabled:
    {
       opacity: 0.5,
    }
  },
  next:
  {
    /**
     * @description The normal field holds an object of exontrol.Def.Shape type that's applied on the part. Indicates an object of exontrol.Def.Shape type that's applied on the part.
     * @type {object}
    */
    normal:
    {
       primitive: "Circle",
       fillColor: "rgb(192,192,192)",
       frameColor: "rgb(128,128,128)",
       text: "&#10095;" // HEAVY RIGHT-POINTING ANGLE QUOTATION MARK ORNAMENT
    },
    /**
     * @description The click field holds an object of exontrol.Def.Shape type that's applied on the part, while it is clicked. Indicates an object of exontrol.Def.Shape type that's applied on the part, while it is clicked
     * @type {object}
    */
    click:
    {
       fillColor: "rgb(164,164,164)",
      tfi:
      {
         fgColor: "gray"
      }
    },
    /**
     * @description The disabled field holds an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled. Indicates an object of exontrol.Def.Shape type that's applied on the part, while the part is disabled
     * @type {object}
    */
    disabled:
    {
       opacity: 0.5,
    }
  }
}