Note.Text Property (ExG2antt)

The Text property is just a shortcut function for PartText property. Use the Text parameter of the Add method to specify the text on the ending part on adding the note. The Text property specifies the PartText for exNoteStart part if visible, else it specifies the PartText for exNoteEnd. The PartForeColor property to specify the part's foreground color. Use the <bgcolor> HTML tag in the PartText property to specify parts of the note's caption with different background colors. The PartAlignment property specifies the text's alignment in the part of the note.

If you need to display a picture only, you need:

if require icons, use the Images method to specify a list of icons that can be displayed in the control
if require custom size pictures, use the HTMLPicture property to add custom- size pictures
set the PartVisible property to show or hide the note's starting or ending part.
use the ClearPartBackColor method to clear the part's background
set the PartBorderSize property is on 0
set the PartShadow property on False

The Text property supports the following:

<%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 )
<%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). ( Use the WeekDays property to specify the name of the days in the week )
<%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). ( Use the WeekDays property to specify the name of the days in the week )
<%loc_d3%> equivalent with <%loc_ddd%>
<%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 )
<%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings.
<%m2%> - First two letters of the month (Ja to De). ( Use the MonthNames property to specify the name of the months in the year )
<%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings.
<%m3%> - First three letters of the month (Jan to Dec). ( Use the MonthNames property to specify the name of the months in the year )
<%loc_m3%> - equivalent with <%loc_mmm%>
<%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).
<%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. ( 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 (:)
<%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

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_d1%> - Indicates day of week as a one-letter abbreviation using the current user settings.
<%loc_d2%> - Indicates day of week as a two-letters abbreviation using the current user settings.
<%loc_d3%> equivalent with <%loc_ddd%>
<%loc_ddd%> - Indicates day of week as a three-letters abbreviation using the current user settings.
<%loc_dddd%> - Indicates day of week as its full name using the current user settings.
<%loc_m1%> - Indicates month as a one-letter abbreviation using the current user settings.
<%loc_m2%> - Indicates month as a two-letters abbreviation using the current user settings.
<%loc_m3%> - equivalent with <%loc_mmm%>
<%loc_mmm%> - Indicates month as a three-letters 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
<%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

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

 ...  displays the text in bold
 ...  displays the text in italics
 ...  underlines the text
<s> ... </s> ~~Strike~~-through text
<a id;options> ... </a> displays an anchor element that can be clicked. An anchor is a piece of text or some other object (for example an image) which marks the beginning and/or the end of a hypertext link.The <a> element is used to mark that piece of text (or inline image), and to give its hypertextual relationship to other documents. The control fires the AnchorClick(AnchorID, Options) event when the user clicks the anchor element. The FormatAnchor property customizes the visual effect for anchor elements.
The control supports expandable HTML captions feature which allows you to expand(show)/collapse(hide) different information using <a ;exp=> or <a ;e64=> anchor tags. The exp/e64 field of the anchor stores the HTML line/lines to show once the user clicks/collapses/expands the caption.
- exp, stores the plain text to be shown once the user clicks the anchor, such as <a ;exp=show lines>
- e64, encodes in BASE64 the HTML text to be shown once the user clicks the anchor, such as <a ;e64=gA8ABmABnABjABvABshIAOQAEAAHAAGESikWio+ABzABohp3iELABpABuABljYAgRhAEaFsqAAvAEsjUCmUEg0IhUMhUPjQAAEBA>+</a> that displays show lines- in gray when the user clicks the + anchor. The gA8ABmABnABjABvABshIAOQAEAAHAAGESikWio+ABzABohp3iELABpABuABljYAgRhAEaFsqAAvAEsjUCmUEg0IhUMhUPjQAAEBA string encodes the <fgcolor 808080>show lines<a>-</a></fgcolor> The Decode64Text/Encode64Text methods of the eXPrint can be used to decode/encode e64 fields.
Any ex-HTML caption can be transformed to an expandable-caption, by inserting the anchor ex-HTML tag. For instance, <solidline>Header</solidline> Line1<r><a ;exp=show lines>+</a> Line2 Line3 shows the Header in underlined and bold on the first line and Line1, Line2, Line3 on the rest. The show lines is shown instead of Line1, Line2, Line3 once the user clicks the + sign.
 ...  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.
<fgcolor rrggbb> ... </fgcolor> or <fgcolor=rrggbb> ... </fgcolor> displays text with a specified foreground color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<bgcolor rrggbb> ... </bgcolor> or <bgcolor=rrggbb> ... </bgcolor> displays text with a specified background color. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<solidline rrggbb> ... </solidline> or <solidline=rrggbb> ... </solidline> draws a solid-line on the bottom side of the current text-line, of specified RGB color. The <solidline> ... </solidline> draws a black solid-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<dotline rrggbb> ... </dotline> or <dotline=rrggbb> ... </dotline> draws a dot-line on the bottom side of the current text-line, of specified RGB color. The <dotline> ... </dotline> draws a black dot-line on the bottom side of the current text-line. The rr/gg/bb represents the red/green/blue values of the color in hexa values.
<upline> ... </upline> draws the line on the top side of the current text-line (requires <solidline> or <dotline>).
<r> right aligns the text
<c> centers the text
  forces a line-break
<img>number[:width]</img> inserts an icon inside the text. 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 into the text being previously 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.
& glyph characters as & ( & ), < ( < ), > ( > ), &qout; ( " ) and &#number; ( the character with specified code ), For instance, the € displays the EUR character. 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
<off offset> ... </off> defines the vertical offset to display the text/element. The offset parameter defines the offset to display the element. This tag is inheritable, so the offset is keep while the associated </off> tag is found. You can use the <off offset> HTML tag in combination with the to define a smaller or a larger font to be displayed. For instance: Text with <off 6>subscript displays the text such as: Text with _subscriptThe Text with <off -6>superscript displays the text such as: Text with ^subscript
<gra rrggbb;mode;blend> ... </gra> defines a gradient text. The text color or <fgcolor> defines the starting gradient color, while the rr/gg/bb represents the red/green/blue values of the ending color, 808080 if missing as gray. The mode is a value between 0 and 4, 1 if missing, and blend could be 0 or 1, 0 if missing. The HTML tag can be used to define the height of the font. Any of the rrggbb, mode or blend field may not be specified. The <gra> with no fields, shows a vertical gradient color from the current text color to gray (808080). For instance the <gra FFFFFF;1;1>gradient-center</gra> generates the following picture:
<out rrggbb;width> ... </out> shows the text with outlined characters, where rr/gg/bb represents the red/green/blue values of the outline color, 808080 if missing as gray, width indicates the size of the outline, 1 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <out 000000><fgcolor=FFFFFF>outlined</fgcolor></out> generates the following picture:
<sha rrggbb;width;offset> ... </sha> define a text with a shadow, where rr/gg/bb represents the red/green/blue values of the shadow color, 808080 if missing as gray, width indicates the size of shadow, 4 if missing, and offset indicates the offset from the origin to display the text's shadow, 2 if missing. The text color or <fgcolor> defines the color to show the inside text. The HTML tag can be used to define the height of the font. For instance the <sha>shadow</sha> generates the following picture:
or <sha 404040;5;0><fgcolor=FFFFFF>outline anti-aliasing</fgcolor></sha> gets:

		Type	Description
		String	A String expression that specifies the HTML text to be displayed on the ending part of the note. The Text parameter supports HTML tags as well as Chart Tags such as <%dd%> that displays the day in 2 digits, and so on like described bellow. Use the Images method to specify a list of icons that can be displayed in the control using the <img> tag. Use the HTMLPicture property to add custom- size pictures to be used in the HTML captions using the <img> tag.