eXontrol Software - Grid-Gantt Chart ActiveX, NET Control

The Label property specifies the label being displayed in the level. Use the Alignment property to specify the label's alignment. Use the ToolTip property to specify the tooltip being displayed when the cursor hovers the level. Use the BackColor and ForeColor properties to change the level's appearance. The Label property changes the Unit property, so Unit property must be called after changing the Label property, if case. For instance, let's say that we have the Label property as : "<%mmm%> <%d%>, '<%yy%>", the Unit property will be automatically set to exDay, because the <%d%> is the minimum unit in the format. The WeekDays property retrieves or sets a value that indicates the list of names for each week day, separated by space. Use the MonthNames property to specify the name of the months in the year. The FormatDate property formats a date. Use the ReplaceLabel property to customize the labels as adding icons/images/pictures or change the captions being displayed by default in the chart's header .

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 )
<%dddd%> - Full name of the weekday (Sunday to Saturday). ( Use the WeekDays property to specify the name of the days in the week )
<%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 )
<%mmmm%> - Full name of the month (January to December). ( Use the MonthNames property to specify the name of the months in the year )
<%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).
<%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 )

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 assign a list of icons to your chart. 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".

The first level displays the month, the year and the number of the week in the year , the second level displays the name of the week day, and the third level displays the day of the month. The LevelCount property specifies the number of levels being displayed, in our case 3.

The following Template shows how to display your header using three levels as arranged in the picture above ( just copy and paste the following script to Template page ):

BeginUpdate()
Chart
{
	LevelCount = 3
	Level(0)
	{
		Label = "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>"
		Unit = 256	'exWeek
	}
	Level(1).Label = "<%d1%>"
	Level(2).Label = "<%d%>"
}
EndUpdate()

The following VB sample displays your header using 3 levels as shown above:

With G2antt1
    .BeginUpdate
    With .Chart
        .LevelCount = 3
        With .Level(0)
            .Label = "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>"
            .Unit = EXG2ANTTLibCtl.UnitEnum.exWeek
        End With
        .Level(1).Label = "<%d1%>"
        .Level(2).Label = "<%d%>"
    End With
    .EndUpdate
End With

The following VFP sample displays your header using 3 levels:

with thisform.g2antt1
.BeginUpdate()
with .Chart
	.LevelCount = 3
	with .Level(0)
		.Label = "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>"
		.Unit = 256
	endwith
	.Level(1).Label = "<%d1%>"
	.Level(2).Label = "<%d%>"
endwith
.EndUpdate()	
endwith

The following VB.NET sample displays your header using 3 levels:

With AxG2antt1
    .BeginUpdate()
    With .Chart
        .LevelCount = 3
        With .Level(0)
            .Label = "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>"
            .Unit = EXG2ANTTLib.UnitEnum.exWeek
        End With
        .Level(1).Label = "<%d1%>"
        .Level(2).Label = "<%d%>"
    End With
    .EndUpdate()
End With

The following C# sample displays your header using 3 levels:

axG2antt1.BeginUpdate();
EXG2ANTTLib.Chart chart = axG2antt1.Chart;
chart.LevelCount = 3;
chart.get_Level(0).Label = "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>";
chart.get_Level(0).Unit = EXG2ANTTLib.UnitEnum.exWeek;
chart.get_Level(1).Label = "<%d1%>";
chart.get_Level(2).Label = "<%d%>";
axG2antt1.EndUpdate();

The following C++ sample displays your header using 3 levels:

m_g2antt.BeginUpdate();
CChart chart = m_g2antt.GetChart();
chart.SetLevelCount( 3 );
chart.GetLevel(0).SetLabel(COleVariant( "<b><%mmm%>, <%yyyy%></b> <r>Week: <%ww%>" ));
chart.GetLevel(0).SetUnit(256);
chart.GetLevel(1).SetLabel(COleVariant( "<%d1%>" ));
chart.GetLevel(2).SetLabel(COleVariant( "<%d%>" ));
m_g2antt.EndUpdate();

Send comments on this topic.

		Type	Description
		Variant	A String expression that indicates the format of the level's label, an UnitEnum expression that indicates the predefined format being used. The Label property defines predefined formats for labales.