The CreateBarEnum type specifies if a new bar is
added automatically or manually during the
CreateBar
event. Use the
AllowCreateBar property
to let user creates new bars by selecting the bar's area at runtime. By
default, the AllowCreateBar is exCreateBarManual.
| | Name | Value | Description | |
| |
exNoCreateBar | 0
|
The user can not create bars by drag an drop. Instead, if the AllowSelectObjects
property is not-zero the user can select objects of the chart by drag and drop.
No CreateBar event is fired.
| |
| |
exCreateBarManual | -1
|
The user can create new bars by drag and drop. If the user clicks the empty portion of the control (anywhere below the last visible item)
the AddItem event occurs where the Item parameter of the event is a negative
value and indicates the number of items to add to fill the empty space. The CreateBar event is fired and no bar is added, so you need to call
AddBar method to add a new bar.
| |
| |
exCreateBarAuto | 1
|
The user can create automatically new bars by drag and drop. If the user clicks the empty portion of the control (anywhere below the last visible item) the control automatically adds new items to fill the empty space and so prior to CreateBar event, several
AddItem event may occur. The CreateBar event is fired and a 'newbar' of 'Task' type is
added. The
exCreateBarAuto option creates empty bars (bars with zero-length) when user
simple clicks the control (no drag). During the CreateEvent you can decide what
to do with the newly created bar: keep, change or remove. Use the ItemBar property to change the key, the
name or any other property of the newly created bar whose exBarKey
property is "newbar" and it's exBarName
is "Task". In other words, when this value is set, the control
automatically adds a new bar to selected position, with the key 'newbar' that
looks like this:  .
If the ChangeBar event is not handled, only a single bar is added to the same
item, as the key is never changed. If you handle the CreateBar event and
assign a different key for the newly created bar, multiple bars can be added at
runtime.
| |
| |
exCreateBarAutoEndInclusive | 2
|
The user can create automatically new bars by drag and drop.
The
exCreateBarAutoEndInclusive value is similar with
exCreateBarAuto, excepts that the end-margin of the bar to create, is defined by the end-date of
the date-time unit from the cursor. If the user clicks and drags the bar over the empty portion of the control (anywhere below the last visible item) the control automatically adds new items to fill the empty space and so prior to CreateBar event, several
AddItem event may occur.
The CreateBar event is fired and a 'newbar' of 'Task' type is
added. No items or bar are automatically created if the user just simple clicks
the chart (no drag).
| |
| |
exCreateBarManualEndInclusive | -2
|
The user can create new bars by drag and drop.
The
exCreateBarManualEndInclusive value is similar with
exCreateBarManual,
excepts that the end-margin of the bar to draw, is defined by the end-date of
the date-time unit from the cursor. If the user clicks and drags the bar over the empty portion of the control
(anywhere below the last visible item) the AddItem event occurs where the Item parameter of the event is a negative
value and indicates the number of items to add to fill the empty space.
The CreateBar event is fired and no bar is added, so you need to call
AddBar method to add a new bar. No AddItem
or CreateBar event is called if
the user just simple clicks the chart (no drag).
| |
