By default, the RelativePosition property is 0.5 if a note is associated with a DATE, and 0, if the note is associated with a BAR. The Key parameter of the Add method determines whether the bar is associated with a DATE or with a BAR. The RelativePosition property always specifies the position of the starting part of the note relative to the DATE or BAR being associated. Use the PartHOffset / PartVOffset property to specify the horizontal / vertical offset relative to the start or end part. The PartCanMove property specifies whether the user can move at runtime the part of the note.

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.

If The RelativePosition property indicates a numeric value the note is displayed relative to the DATE or BAR as follow:

• if the note is associated with a DATE ( the Key parameter of the Add method is of DATE type ), 0 indicates the starting of the unit where the DATE is, 1 indicates the finish of the time unit where the DATE is, and 0.5 indicates the center of the unit.
• if the note is associated with a BAR ( the Key parameter of the Add method is of DATE type ), 0 indicates the starting point of the bar, 1 indicates the ending point of the bar, 0.5 indicates the middle of the bar. 

If The RelativePosition property indicates a string expression that starts with S or E the note is displayed relative to the BAR (ONLY) as follow:

• starts with "S" it indicates that the note is related to starting point of the bar /ItemBar(exBarStart)/, while the following number in the string expression determines the number of days to display the note relative to the starting point of the bar. For instance, the "S+3" indicates that the note is displayed 3 days later after the bar starts. The note is moved automatically once the starting point of the bar is updated.
• starts with "E" it indicates that the note is related to ending point of the bar /ItemBar(exBarEnd)/, while the following number in the string expression determines the number of days to display the note relative to the ending point of the bar. For instance, the "E-1" indicates that the note is displayed 1 day before bar ends. The note is moved automatically once the ending point of the bar is updated.

The PartHOffset / PartVOffset properties indicate the horizontal / vertical offset as follow:

• for exNoteStart, the PartHOffset / PartVOffset properties indicate the offset relative to the point referred by the RelativePosition property.
• for exNoteEnd, the PartHOffset / PartVOffset properties indicate the offset relative to the exNoteStart

The moving cursor is shown on the movable part if:

• the part is visible and it means the PartVisible property is True, and it is visible on the screen ( has the PartText not empty, or has the both PartFixedWidth / PartFixedHeight properties not zero )
• the exNoteStart is movable, and it means that the PartCanMove(exNoteStart) property is True
• the exNoteEnd is movable, and it means that the PartCanMove(exNoteStart) OR PartCanMove(exNoteEnd) property is True.

The following screen shows shows how the notes can be moved by the user: