Gantt View: Difference between revisions
(New page: The Gantt View display is a type where overlays are interpreted as “horizontal bars” in a Gantt chart. Image:Gantt_view.jpg ==Gantt View Required Columns== Special Column Names ar...) |
No edit summary |
||
Line 3: | Line 3: | ||
==Gantt View Required Columns== | ==Gantt View Required Columns== | ||
Special Column Names are required for a Gantt View to Display correctly. | Special Column Names are required for a Gantt View to Display correctly. | ||
'''_time''', '''_position''' & '''_state''' are required to get a display, other columns are optional | '''_time''', '''_position''' & '''_state''' are required to get a display, other columns are optional | ||
{| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | {| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | ||
!Column Name !!Description | !Column Name !!Description | ||
|- | |- | ||
|_time | |_time | ||
|Determines x axis, (must be ascending) | |Determines x axis, (must be ascending) | ||
|- | |- | ||
|_position | |_position | ||
|Determines Gantt row number ( as a Y scale offset) | |Determines Gantt row number ( as a Y scale offset) | ||
|- | |- | ||
|_label | |_label | ||
|Shown in the bar if that option selected | |Shown in the bar if that option selected | ||
|- | |- | ||
|_state | |_state | ||
|Sets the colour of a Bar. | |Sets the colour of a Bar. | ||
0 = inactive, 1..15 etc map to system colours. | 0 = inactive, 1..15 etc map to system colours. | ||
A value of 0 causes no bar to be drawn – and this is therefore how you end a bar. | A value of 0 causes no bar to be drawn – and this is therefore how you end a bar. | ||
|- | |- | ||
|_color | |_color | ||
|The color of the Bar. | |The color of the Bar. | ||
If a '''_color''' column is present, the colour as specified in it will be used, in place of '''_State'''. | If a '''_color''' column is present, the colour as specified in it will be used, in place of '''_State'''. | ||
If not, the original colour mapping algorithm is used, which maps '''_state''' to colours but avoids the background colour. | If not, the original colour mapping algorithm is used, which maps '''_state''' to colours but avoids the background colour. | ||
|- | |- | ||
|_width | |_width | ||
|Width of the Border around the gantt (if drawn) | |Width of the Border around the gantt (if drawn) | ||
|- | |- | ||
|_borderstyle | |_borderstyle | ||
|Specifies a value from the "_border styles" label list and determines the style of border the gantt block is drawn with. | |Specifies a value from the "_border styles" label list and determines the style of border the gantt block is drawn with. | ||
|- | |- | ||
|_bordercolor | |_bordercolor | ||
|Specifies a colour and determines the colour of the border used when drawing the gantt block (note: indent/shadow borders do not use this color. | |Specifies a colour and determines the colour of the border used when drawing the gantt block (note: indent/shadow borders do not use this color. | ||
|- | |- | ||
|_nodeid | |_nodeid | ||
|Individual identification of a Node, which is one or another end of a Bar. | |Individual identification of a Node, which is one or another end of a Bar. | ||
_nodeid enables an identifier for a gantt block to be specified. | _nodeid enables an identifier for a gantt block to be specified. | ||
A block further in time can be linked back to that previous block by setting its _link_nodeid to the same value as the previous block. Many blocks can use the same _nodeid, PL will always search for the most recent block (not including the current). | A block further in time can be linked back to that previous block by setting its _link_nodeid to the same value as the previous block. Many blocks can use the same _nodeid, PL will always search for the most recent block (not including the current). | ||
Hence to connect a series of blocks together, setting their _nodeid and _link_nodeid values to a common value (eg: consist #) will display a line linking the blocks together. | Hence to connect a series of blocks together, setting their _nodeid and _link_nodeid values to a common value (eg: consist #) will display a line linking the blocks together. | ||
|- | |- | ||
|_link_nodeid | |_link_nodeid | ||
|See above | |See above | ||
|- | |- | ||
|_link_color | |_link_color | ||
|Colour of Node Link line. | |Colour of Node Link line. | ||
|- | |- | ||
|_link_width | |_link_width | ||
|Width of Node Link line. | |Width of Node Link line. | ||
|} | |} | ||
The Label colour can be set for a Gantt, separately to the bar colour. | The Label colour can be set for a Gantt, separately to the bar colour. | ||
A label list can be assigned as the left hand side titles of the Gantt rows. | A label list can be assigned as the left hand side titles of the Gantt rows. | ||
Clicking on the bar in the Gantt pops up a window with details of the values in other cells. | Clicking on the bar in the Gantt pops up a window with details of the values in other cells. | ||
Table columns have an option item to flag inclusion in this popup. Start/end times of event are shown in the popup by default, but can be suppressed. | Table columns have an option item to flag inclusion in this popup. Start/end times of event are shown in the popup by default, but can be suppressed. | ||
Line 70: | Line 70: | ||
==Gantt View Options== | ==Gantt View Options== | ||
{| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | {| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | ||
!Option !! Description | !Option !! Description | ||
|- | |- | ||
|Show Bar Labels | |Show Bar Labels | ||
|Display the _Label content inside the Bars. | |Display the _Label content inside the Bars. | ||
|- | |- | ||
|Show bar Times | |Show bar Times | ||
|Display the Time values at each end of a bar. | |Display the Time values at each end of a bar. | ||
|- | |- | ||
|Draw From Top | |Draw From Top | ||
|Draw the bars with the offsets beginning off the top of the chart rather than the bottom. | |Draw the bars with the offsets beginning off the top of the chart rather than the bottom. | ||
|- | |- | ||
|Vertical Scrollbar | |Vertical Scrollbar | ||
|If there are more bars than can fit in the display, a vertical scrollbar will be provided. | |If there are more bars than can fit in the display, a vertical scrollbar will be provided. | ||
|- | |- | ||
|Show links at Front | |Show links at Front | ||
|Link Lines are drawn in front of the Gantt Bars. | |Link Lines are drawn in front of the Gantt Bars. | ||
|- | |- | ||
|Align Row Labels at Left | |Align Row Labels at Left | ||
|Line up Bar Labels along Y axis of chart. | |Line up Bar Labels along Y axis of chart. | ||
|- | |- | ||
|Hide Time scroller | |Hide Time scroller | ||
|Hides the Time interval zoom scroller. | |Hides the Time interval zoom scroller. | ||
|- | |- | ||
|No Times in Bar popups | |No Times in Bar popups | ||
|Suppress the display of Times in the popup that is displayed when you click on a gantt bar. | |Suppress the display of Times in the popup that is displayed when you click on a gantt bar. | ||
|} | |} | ||
==Gantt View Parameters== | ==Gantt View Parameters== | ||
These options adjust how a gantt graph is displayed. | These options adjust how a gantt graph is displayed. | ||
;Bar Thickness %:sets the height of the gantt bars, as a proportion of the total row area. The default is 80%. | ;Bar Thickness %:sets the height of the gantt bars, as a proportion of the total row area. The default is 80%. | ||
;Bar Offset %:sets the y offset in the bar, as a proportion of the total row area. A positive or negative percentage can be specified. | ;Bar Offset %:sets the y offset in the bar, as a proportion of the total row area. A positive or negative percentage can be specified. | ||
;Text Offset %:sets the y offset for text displayed in the bar, as a proportion of the total row area. A positive or negative percentage can be specified. | ;Text Offset %:sets the y offset for text displayed in the bar, as a proportion of the total row area. A positive or negative percentage can be specified. | ||
==Gantt View Properties== | ==Gantt View Properties== | ||
The Properties Flyout provides access to a number of aspects of the View. | The Properties Flyout provides access to a number of aspects of the View. | ||
{| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | {| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | ||
!Property !! Description | !Property !! Description | ||
|- | |- | ||
|Graphics | |Graphics | ||
|Displays the Graphics Configuration Dialog which enables you to Set | |Displays the Graphics Configuration Dialog which enables you to Set | ||
Border Style; Border Colour; Background Colour; Text Colour. | Border Style; Border Colour; Background Colour; Text Colour. | ||
|- | |- | ||
|Position | |Position | ||
|Use this option to reposition the View. Alternatively just drag it around. | |Use this option to reposition the View. Alternatively just drag it around. | ||
|- | |- | ||
|Initial X Width | |Initial X Width | ||
|Acts as a width limit for the X axis of a View. You can still stretch the scroller past this but it will revert to the limit when the data is changed by the model. | |Acts as a width limit for the X axis of a View. You can still stretch the scroller past this but it will revert to the limit when the data is changed by the model. | ||
|- | |- | ||
|Min Update | |Min Update | ||
|By default, a Graph View is updated each time the table is changed. Sometimes you may wish to have your graphs update at a lesser rate than these events. This will specify the time between updates of the graph, regardless of the number of events that have occurred in between. | |By default, a Graph View is updated each time the table is changed. Sometimes you may wish to have your graphs update at a lesser rate than these events. This will specify the time between updates of the graph, regardless of the number of events that have occurred in between. | ||
|- | |- | ||
|# of rows | |# of rows | ||
|- | |- | ||
|Row Offset | |Row Offset | ||
|- | |- | ||
|Row Labels | |Row Labels | ||
|- | |- | ||
|Label Text Colour | |Label Text Colour | ||
|- | |- | ||
|Label Time Colour | |Label Time Colour | ||
|} | |} | ||
Line 137: | Line 137: | ||
==Gantt View Scale Options== | ==Gantt View Scale Options== | ||
There are options you can choose to enhance the look of your View. Certain scale options are available here. | There are options you can choose to enhance the look of your View. Certain scale options are available here. | ||
{| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | {| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | ||
!Option !! Description | !Option !! Description | ||
|- | |- | ||
|Show X Scales / Show Y Scales | |Show X Scales / Show Y Scales | ||
|Hide/Show the scale values in the View. | |Hide/Show the scale values in the View. | ||
|- | |- | ||
|Show X Major Grid / Show Y Major Grid | |Show X Major Grid / Show Y Major Grid | ||
|Shows a Major Grid line for the Scale, when the scale parameters are set appropriately. | |Shows a Major Grid line for the Scale, when the scale parameters are set appropriately. | ||
|- | |- | ||
|Show X Minor Grid / Show Y Minor Grid | |Show X Minor Grid / Show Y Minor Grid | ||
|Shows a Minor Grid line for the Scale, when the scale parameters are set appropriately. | |Shows a Minor Grid line for the Scale, when the scale parameters are set appropriately. | ||
|} | |} | ||
==Gantt View Broadcasts== | ==Gantt View Broadcasts== | ||
Certain Model User interactions with Views can have Broadcasts associated with them. You can associate the Broadcast of your choice for the following. | Certain Model User interactions with Views can have Broadcasts associated with them. You can associate the Broadcast of your choice for the following. | ||
All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself. | All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself. | ||
{| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | {| border="1" style="border:1px #AAA solid; border-collapse:collapse;" | ||
!Broadcast Name !! Description of Event | !Broadcast Name !! Description of Event | ||
|- | |- | ||
|Click Broadcast | |Click Broadcast | ||
|Transmitted when the user clicks on the graph. | |Transmitted when the user clicks on the graph. | ||
|- | |- | ||
|Scroll Broadcast | |Scroll Broadcast | ||
|Transmitted when the user scrolls the View of the Gantt. | |Transmitted when the user scrolls the View of the Gantt. | ||
|} | |} | ||
Line 169: | Line 169: | ||
==Visibility Control== | ==Visibility Control== | ||
The Run-Time visibility of an Attribute View can be managed by setting up conditions in the condition editor. | The Run-Time visibility of an Attribute View can be managed by setting up conditions in the condition editor. | ||
You can make references to the values of a range of other attributes. | You can make references to the values of a range of other attributes. | ||
Generally, you will need to enforce a refresh of the Screen display via a “Force Repaint” routine operation in a change object before a hidden attribute view that should now become visible will be seen. | Generally, you will need to enforce a refresh of the Screen display via a “Force Repaint” routine operation in a change object before a hidden attribute view that should now become visible will be seen. | ||
==Edit Original== | ==Edit Original== | ||
This is the option that displays the Table Editor Window. | This is the option that displays the Table Editor Window. | ||
Alternatively, double click on the Title of the Table View to display this window. | Alternatively, double click on the Title of the Table View to display this window. | ||
==Copy== | ==Copy== | ||
Copies the View of this table and enables you to paste another View, with all the same settings, on another panel. | Copies the View of this table and enables you to paste another View, with all the same settings, on another panel. | ||
==View Order== | ==View Order== | ||
Line 188: | Line 188: | ||
[[Category:Data]] | [[Category:Data]] | ||
[[Category:Graphics]] | [[Category:Graphics]] | ||
[[Category:Table]] | |||
[[Category:View]] |
Revision as of 12:02, 15 July 2008
The Gantt View display is a type where overlays are interpreted as “horizontal bars” in a Gantt chart.
Gantt View Required Columns
Special Column Names are required for a Gantt View to Display correctly.
_time, _position & _state are required to get a display, other columns are optional
Column Name | Description |
---|---|
_time | Determines x axis, (must be ascending) |
_position | Determines Gantt row number ( as a Y scale offset) |
_label | Shown in the bar if that option selected |
_state | Sets the colour of a Bar.
0 = inactive, 1..15 etc map to system colours. A value of 0 causes no bar to be drawn – and this is therefore how you end a bar. |
_color | The color of the Bar.
If a _color column is present, the colour as specified in it will be used, in place of _State. If not, the original colour mapping algorithm is used, which maps _state to colours but avoids the background colour. |
_width | Width of the Border around the gantt (if drawn) |
_borderstyle | Specifies a value from the "_border styles" label list and determines the style of border the gantt block is drawn with. |
_bordercolor | Specifies a colour and determines the colour of the border used when drawing the gantt block (note: indent/shadow borders do not use this color. |
_nodeid | Individual identification of a Node, which is one or another end of a Bar.
_nodeid enables an identifier for a gantt block to be specified. A block further in time can be linked back to that previous block by setting its _link_nodeid to the same value as the previous block. Many blocks can use the same _nodeid, PL will always search for the most recent block (not including the current). Hence to connect a series of blocks together, setting their _nodeid and _link_nodeid values to a common value (eg: consist #) will display a line linking the blocks together. |
_link_nodeid | See above |
_link_color | Colour of Node Link line. |
_link_width | Width of Node Link line. |
The Label colour can be set for a Gantt, separately to the bar colour.
A label list can be assigned as the left hand side titles of the Gantt rows.
Clicking on the bar in the Gantt pops up a window with details of the values in other cells.
Table columns have an option item to flag inclusion in this popup. Start/end times of event are shown in the popup by default, but can be suppressed.
Gantt View Options
Option | Description |
---|---|
Show Bar Labels | Display the _Label content inside the Bars. |
Show bar Times | Display the Time values at each end of a bar. |
Draw From Top | Draw the bars with the offsets beginning off the top of the chart rather than the bottom. |
Vertical Scrollbar | If there are more bars than can fit in the display, a vertical scrollbar will be provided. |
Show links at Front | Link Lines are drawn in front of the Gantt Bars. |
Align Row Labels at Left | Line up Bar Labels along Y axis of chart. |
Hide Time scroller | Hides the Time interval zoom scroller. |
No Times in Bar popups | Suppress the display of Times in the popup that is displayed when you click on a gantt bar. |
Gantt View Parameters
These options adjust how a gantt graph is displayed.
- Bar Thickness %
- sets the height of the gantt bars, as a proportion of the total row area. The default is 80%.
- Bar Offset %
- sets the y offset in the bar, as a proportion of the total row area. A positive or negative percentage can be specified.
- Text Offset %
- sets the y offset for text displayed in the bar, as a proportion of the total row area. A positive or negative percentage can be specified.
Gantt View Properties
The Properties Flyout provides access to a number of aspects of the View.
Property | Description |
---|---|
Graphics | Displays the Graphics Configuration Dialog which enables you to Set
Border Style; Border Colour; Background Colour; Text Colour. |
Position | Use this option to reposition the View. Alternatively just drag it around. |
Initial X Width | Acts as a width limit for the X axis of a View. You can still stretch the scroller past this but it will revert to the limit when the data is changed by the model. |
Min Update | By default, a Graph View is updated each time the table is changed. Sometimes you may wish to have your graphs update at a lesser rate than these events. This will specify the time between updates of the graph, regardless of the number of events that have occurred in between. |
# of rows | |
Row Offset | |
Row Labels | |
Label Text Colour | |
Label Time Colour |
Gantt View Scale Parameters
There are many details you can choose to enhance the look of your View. Certain scale parameters are available here.
Gantt View Scale Options
There are options you can choose to enhance the look of your View. Certain scale options are available here.
Option | Description |
---|---|
Show X Scales / Show Y Scales | Hide/Show the scale values in the View. |
Show X Major Grid / Show Y Major Grid | Shows a Major Grid line for the Scale, when the scale parameters are set appropriately. |
Show X Minor Grid / Show Y Minor Grid | Shows a Minor Grid line for the Scale, when the scale parameters are set appropriately. |
Gantt View Broadcasts
Certain Model User interactions with Views can have Broadcasts associated with them. You can associate the Broadcast of your choice for the following.
All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself.
Broadcast Name | Description of Event |
---|---|
Click Broadcast | Transmitted when the user clicks on the graph. |
Scroll Broadcast | Transmitted when the user scrolls the View of the Gantt. |
Gantt View Table Column Check
Use this dialog to find out whether you have included all the columns that a gantt needs to respond and display properly. It indicates which labels are required, and which of those are missing.
Visibility Control
The Run-Time visibility of an Attribute View can be managed by setting up conditions in the condition editor.
You can make references to the values of a range of other attributes.
Generally, you will need to enforce a refresh of the Screen display via a “Force Repaint” routine operation in a change object before a hidden attribute view that should now become visible will be seen.
Edit Original
This is the option that displays the Table Editor Window.
Alternatively, double click on the Title of the Table View to display this window.
Copy
Copies the View of this table and enables you to paste another View, with all the same settings, on another panel.
View Order
The view order of Attributes can be altered, but only in relation to other Attribute Views, not to Paint Objects or Planimate® Objects.