Exontrol - Gantt Chart ActiveX, NET, WPF Control

The Label property specifies a predefined label for a specified unit. Use the UnitScale property to change the scale unit. The UnitScale property changes the Label, Unit and the ToolTip for a level with predefined values defined by the Label and LabelToolTip properties. Use the UnitWidth property to specify the width of the time unit. Use the Zoom method to zoom the chart to a specified interval of dates. Use the Label property to assign a different label for a specified level. Use the LabelToolTip property to specify the predefined type of tooltip being displayed when the chart is zoomed. Use the ToolTip property to specify the tooltip that shows up when the cursor hovers the level. Use the FormatDate property to format a date. Use the MonthNames property to specify the name of the months in the year. The WeekDays property retrieves or sets a value that indicates the list of names for each week day, separated by space. If the Label property is empty, the unit is not displayed in the zooming scale, if the AllowOverviewZoom property is not exDisableZoom.

The Label property supports alternative HTML labels being separated by "<|>" and values for Count and Unit being separated by "<||>". By alternate HTML label we mean that you can define a list of HTML labels that may be displayed in the chart's header based on the space allocated for the time-unit. In other words, the control chooses automatically the alternate HTML label to be displayed for best fitting in the portion of the chart where the time-unit should be shown.

The Label property format is "ALT1[<|>ALT2<|>...[<||>COUNT[<||>UNIT]]]" where

ALT defines a HTML label
COUNT specifies the value for the Count property
UNIT field indicates the value for the Unit property
and the parts delimited by [] brackets may miss.

The Label property may change the Unit and the Count property. You can always use a different Unit or Count by setting the property after setting the Label property.

The Label property supports the following built-in tags:

<%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). ( Use the WeekDays property to specify the name of the days in the week )
<%d2%> - First two letters of the weekday (Su to Sa). ( Use the WeekDays property to specify the name of the days in the week )
<%d3%> - First three letters of the weekday (Sun to Sat). ( Use the WeekDays property to specify the name of the days in the week )
<%ddd%> - First three letters of the weekday (Sun to Sat). ( Use the WeekDays property to specify the name of the days in the week ). You can use the <%loc_ddd%> that indicates the day of week as a three-letter abbreviation using the current user regional and language settings.
<%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). ( Use the WeekDays property to specify the name of the days in the week ). You can use the <%loc_dddd%> that indicates day of week as its full name using the current user regional and language settings.
<%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. For instance, you can display numbers as 1000, 1001, 1002, 1003, instead dates. ( the valid range is from -647,434 to 2,958,465 )
<%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). ( Use the MonthNames property to specify the name of the months in the year )
<%m2%> - First two letters of the month (Ja to De). ( Use the MonthNames property to specify the name of the months in the year )
<%m3%> - First three letters of the month (Jan to Dec). ( Use the MonthNames property to specify the name of the months in the year )
<%mmm%> - First three letters of the month (Jan to Dec). ( Use the MonthNames property to specify the name of the months in the year ). You can use the <%loc_mmm%> that indicates month as a three-letter abbreviation using the current user regional and language settings.
<%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). ( Use the MonthNames property to specify the name of the months in the year ). You can use the <%loc_mmmm%> that indicates month as its full name using the current user regional and language settings.
<%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_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).
<%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. ( Use the AMPM property to specify the name of the AM and PM indicators ). You can use the <%loc_AM/PM%> that indicates the time marker such as AM or PM using the current user regional and language settings. You can use <%loc_A/P%> that indicates the one character time marker such as A or P using the current user regional and language settings
<%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 (:).

The following tags are displayed based on the user's Regional and Language Options:

<%loc_sdate%> - Indicates the date in the short format using the current user settings.
<%loc_ldate%> - Indicates the date in the long format using the current user settings.
<%loc_ddd%> - Indicates day of week as a three-letter abbreviation using the current user settings.
<%loc_dddd%> - Indicates day of week as its full name using the current user settings.
<%loc_mmm%> - Indicates month as a three-letter abbreviation using the current user settings.
<%loc_mmmm%> - Indicates month as its full name using the current user settings.
<%loc_gg%> - Indicates period/era using the current user settings.
<%loc_dsep%> - Indicates the date separator using the current user settings.
<%loc_time%> - Indicates the time using the current user settings.
<%loc_time24%> - Indicates the time in 24 hours format without a time marker using the current user settings.
<%loc_AM/PM%> - Indicates the time marker such as AM or PM using the current user settings.
<%loc_A/P%> - Indicates the one character time marker such as A or P using the current user settings.
<%loc_tsep%> - Indicates the time separator using the current user settings.

The Label property supports the following built-in HTML tags:

 bold bolds a part of the caption.
 underline specifies that the portion should appear as underlined.
<s> ~~strikeout~~ </s> specifies that the portion should appear as strikeout.
 italic specifies that the portion should appear as italic.
<fgcolor=FF0000>fgcolor</fgcolor> changes the foreground color for a portion.
<bgcolor=FF0000>bgcolor</bgcolor> changes the background color for a portion.
  breaks a line.
<solidline> draws a solid line. If has no effect for a single line caption.
<dotline> draws a dotted line. If has no effect for a single line caption.
<upline> draws the line to the top of the text line
<r> aligns the rest of the text line to the right side. It has no effect if the caption contains a single line.
<img>number[:width]</img> inserts an icon inside the cell's caption. The number indicates the index of the icon being inserted. Use the Images method to load a list of icons in the control. The last 7 bits in the high significant byte of the number expression indicates the identifier of the skin being used to paint the object. Use the Add method to add new skins to the control. If you need to remove the skin appearance from a part of the control you need to reset the last 7 bits in the high significant byte of the color being applied to the part. The width is optional and indicates the width of the icon being inserted. Using the width option you can overwrite multiple icons getting a nice effect. By default, if the width field is missing, the width is 18 pixels.
<img>key[:width]</img> inserts a custom size picture being loaded using the HTMLPicture property. The Key parameter indicates the key of the picture being displayed. The Width parameter indicates a custom size, if you require to stretch the picture, else the original size of the picture is used.
text displays portions of text with a different font and/or different size. For instance, the bit draws the bit text using the Tahoma font, on size 12 pt. If the name of the font is missing, and instead size is present, the current font is used with a different size. For instance, bit displays the bit text using the current font, but with a different size.
& glyph characters as &amp ( & ), &lt ( < ), &gt ( > ), &qout ( " ), &#number, For instance, the &#8364 displays the EUR character, in UNICODE configuration. The & ampersand is only recognized as markup when it is followed by a known letter or a # character and a digit. For instance if you want to display bold in HTML caption you can use bold

The Label property may be a combination of any of these tags. For instance, the "<%mmm%> <%d%>, '<%yy%>" displays a date like: "May 29,'05".

By default, the Label property is:

exYear: "<%yy%><|>'<%yy%><|><%yyyy%>"
exHalfYear: ""
exQuarterYear: ""
exMonth: "<|><%m1%><|><%m2%><|><%m3%><|><%mmmm%><|><%m3%> '<%yy%><|><%mmmm%> <%yyyy%>"
exThirdMonth: ""
exWeek: "<|><%ww%><|><%m3%> <%d%>, '<%yy%><r><%ww%><|><%mmmm%> <%d%>, <%yyyy%><r><%ww%><||><||>256"
exDay: "<|><%d1%><|><%d2%><|><%d3%><|><%dddd%><|><%d3%>, <%m3%> <%d%>, '<%yy%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%><||><||>4096"
exHour: "<|><%hh%><|><%h%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%> <%AM/PM%><||><||>65536"
exMinute: "<|><%nn%><|><%h%>:<%nn%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%>:<%nn%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%>:<%nn%> <%AM/PM%>"
exSecond: "<|><%ss%><|><%nn%>:<%ss%><|><%h%>:<%nn%>:<%ss%> <%AM/PM%><|><%d3%>, <%m3%> <%d%>, '<%yy%> <%h%>:<%nn%>:<%ss%> <%AM/PM%><|><%dddd%>, <%mmmm%> <%d%>, <%yyyy%> <%h%>:<%nn%>:<%ss%> <%AM/PM%>"

For instance the Label(exWeek) is "<|><%ww%><|><%m3%> <%d%>, '<%yy%><r><%ww%><|><%mmmm%> <%d%>, <%yyyy%><r><%ww%><||><||>256" which means that if a level's unit is set on exWeek it may display one of the following alternate labels:

nothing, if the space is less than 6 pixels
<%ww%> - week number
<%m3%> <%d%>, '<%yy%><r><%ww%> - month, day, year in short format where the week begins, including the week number on the right
<%mmmm%> <%d%>, <%yyyy%><r><%ww%> - month, day, year in long format where the week begins, including the week number on the right

So actually, the control will choose any of these formats based on the UnitWidth, Font and the layout of the levels.

Send comments on this topic.

		Type	Description
		Unit as UnitEnum	An UnitEnum expression that indicates the time unit
		String	A String expression that includes the format of the label.