^(exn2tes) The Notes collection holds a collection of Note objects. A note can be associated with a DATE in the chart or can be associated to a BAR in the chart. A note is a box that moves together with the related object. For instance, if a note is associated with the starting point of the bar ( start date ), and the user resizes the bar in the left side ( so it changes the starting point of the bar ), the related box/note is moved relatively too. The Notes object can be accessed through the Notes property of the Chart object. A Note or a Box can display HTML captions, images, icons, borders, links, and it is fully customizable. The note is composed by two parts, the starting part and end part, that can be linked together. The start part is related to the DATE or to the BAR, while the end part is related to the start part of the note, such us if the start part is moved, the end part is relatively moved. The user can move the end part around the start part, while the start part remains unchanged, or can move so the entire box is moved relatively to the object ( DATE or BAR ). Use the Items.ItemBar(exBarCaption) property to assign a HTML text, icons, pictures to a bar. Use the Items.ItemBar(exBarExtraCaption) property to add or associate extra captions to a bar.

Using notes feature of the control you can associate notes or boxes to dates or bars as follow:

• associate a note or a box to a DATE in the chart control. The note is shown relative to the date in the chart area, so once the chart is scrolled the note is moved or repositioned accordingly to the date. The vertical position of the note is determined by the item that hosts the note, and the  PartVOffset property. The RelativePosition is a number expression that determines whether the note is associated with the start of the date, end of the date, or a percent.
• associate a note or a box relative to a BAR in the chart control. The note is shown relative to the bar in the chart area, so once the bar is moved or resized the note is shown accordingly  to the bar. The vertical position of the note is determined by the item that hosts the note, and the  PartVOffset property. In this case, the type of the RelativePosition property determines how the note is related to the bar using the following rules:
  • is a numeric expression, the RelativePosition determines the position to display the note relative to the range of the bar, determined by the starting /ItemBar(exBarStart)/ and ending /ItemBar(exBarEnd)/ point of the bar. For instance, if the RelativePosition property is 0.5 the note is being displayed in the middle of the bar, while if the RelativePosition property is 1, the note is positioned at the end of the bar. If the user resizes the bar, its range is changed, so the note is moved accordingly.
  • a string expression that starts with S or E being followed by numeric expression ( sample "E-1", "E-0.5", "S+2" ) it determines the note to be relative to the starting point of the bar if starts with S, or relative to the end of the bar if it starts with E. The numeric expression that follows to S or E determines the number of days to be positioned the note. For instance, the "E-1", indicates that the note is positioned one day before bar ends. If the user resizes the ending point of the bar, the note will always be displayed one day before it ends, and so on. The "S+2" , indicates that the note will be displayed 2 days after bar starts, and if the user resizes the bar, the note will always be displayed 2 days after the starting point of the bar. The "E-0.5" indicates that the note will be displayed 12 hours ( 1/2 or 0.5 from a day ) before bar ends.

The following animated screen shows some of capabilities for notes:

The following screen shot shows notes//boxes associated to bars:

 

The following screen shot shows notes//boxes associated to bars:

 

 

The Notes collection supports the following properties and methods: