Table View: Difference between revisions

From Planimate Knowledge Base
Jump to navigation Jump to search
No edit summary
No edit summary
 
Line 1: Line 1:
Planimate tables can appear directly on panels along with objects in the model and paint buttons, making it possible to build comprehensive data input and display panels.
Planimate tables can appear directly on panels along with objects in the model and paint buttons, making it possible to build comprehensive data input and display panels.  


A number of types of table views exist, the most common being a grid of cells like the table editor. This view is described on this page. Other table view types include:
A number of types of table views exist, the most common being a grid of cells like the table editor. This view is described on this page. Other table view types include:  


*[[Cell View|Cell Views]] for displaying/editing individual cells
*[[Cell View|Cell Views]] for displaying/editing individual cells  
*[[Column_Overlay_Graph_View|Column Overlay Views]] which can graph multiple columns as multiple plots on one graph
*[[Column Overlay Graph View|Column Overlay Views]] which can graph multiple columns as multiple plots on one graph  
*[[Log_Driven_Graph|Log Driven Views]] which create complex graphs using a number of pre-defined columns to control plotting position, colour, which overlay plot and other styles.
*[[Log Driven Graph|Log Driven Views]] which create complex graphs using a number of pre-defined columns to control plotting position, colour, which overlay plot and other styles.  
*[[Gantt_View|Gantt Views]], optimised for drawing gantt charts including labels and linking lines
*[[Gantt View|Gantt Views]], optimised for drawing gantt charts including labels and linking lines  
*[[Train_Graph_View|Train Graph Views]], optimised for drawing line charts often used to visualise train motion between locations over time  
*[[Train Graph View|Train Graph Views]], optimised for drawing line charts often used to visualise train motion between locations over time  
*[[Grid_View|Grid Views]], a visualisation of a table as an array of icons or coloured pixels.
*[[Grid View|Grid Views]], a visualisation of a table as an array of icons or coloured pixels.


__TOC__
__TOC__  


== Basic Editing ==
== Basic Editing ==


A view of a table can be added to the current panel by selecting one of the options at the top of the View menubar in the [[Table_Editor|Table Editor Window]].
A view of a table can be added to the current panel by selecting one of the options at the top of the View menubar in the [[Table Editor|Table Editor Window]].  


Multiple views of a given type can appear on a given panel so take care not to have a view covering another. They can be repositioned by dragging their title area or from the context menu.
Multiple views of a given type can appear on a given panel so take care not to have a view covering another. They can be repositioned by dragging their title area or from the context menu.  


Editing data in a table view is similar to editing in the table editor, however you can control which features are available using the [[Table_View_Options_Choices|Table View's Options]] and can take extreme control of the view's behaviour using click broadcasts. There are also additional graphics options for customising many colours in the view.
Editing data in a table view is similar to editing in the table editor, however you can control which features are available using the [[Table View Options Choices|Table View's Options]] and can take extreme control of the view's behaviour using click broadcasts. There are also additional graphics options for customising many colours in the view.  


You can quickly access the original table for a view by double clicking on it.
You can quickly access the original table for a view by double clicking on it.  


== Click &amp; Sort Broadcasts<br> ==
== Broadcasts ==


== View Properties ==
Certain interactions with Table Views can have [[broadcast|Broadcasts ]]associated with them, enabling the modeller to customise how the view responds when cells are clicked.<br>


== Row Filters ==
All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself.


== Customised Column Views ==
Broadcast Name Description of Event


== Model Driven View ==
Cell Click Broadcast Transmitted when the user clicks on a cell to edit it, or after the user has edited a cell (with appropriate option set for the view).<br> After Sort Broadcast Transmitted when the user performs a sort of the Table (with appropriate option set in the Table Editor).<br> Scroll Broadcast Transmitted when the user scrolls the View of the Table.<br>


=== Customising ===
== Row Filters  ==


=== Selecting ===
== Customised Column Views  ==


=== Copy/Paste ===
== Model Changes To Views<br> ==


=== Filtering ===
=== Customising  ===


===  ===
=== Selecting ===


Table View Options
=== Copy/Paste  ===


Option Description
=== Filtering  ===


*In Place Edits Table Cells can be edited by a Model User.
== Properties  ==
*Hide Horiz. Scrollbar Hides the Horizontal Scrollbar - Table View can still be navigated in full with arrow keys.
*Hide Vert Scrollbar Hides the Vertical Scrollbar - Table View can still be navigated in full with arrow keys.
*Hide Title Hides the Title of the Table in the View.
*Send Broadcast after Edit If this is selected, then the Cell Click broadcast is sent after the User actually Edits the cell and presses enter, or closes the cell edit in some way.
*Don’t Defer BC on FEC Enables Broadcasts to be sent and immediately processed after a Table edit, retaining full editing of the table under modeller control.
*Full Edit menu with BC's This shows the full editing context menu when a table cell is right clicked even if an edit broadcast is being sent. Used with the Don’t Defer BC on FEC option, it retains with the context menu retaining all its options. "Full Edit Menu With Broadcasts." also applies to the table's row select menu - ie: makes it available when cell click broadcasts are being sent.
*No Row Editing Prevents Row editing by a model user.
*Transparent to Clicks Makes the Table View “Display Only” - Model Users cannot even click on it to select and copy cells etc.
*Single Click to Edit Makes the Table View cells sensitive to a single click only to activate editing.
*Disable Block Edits Prevents editing of Selections of Cells - Copy is allowed, but Paste operations for a selection is not allowed.
*Don’t Show Current Cell Prevents the highlighting of the ‘current’ cell in a Table View. Good for Display-only table views.
 
<br>
 
=== Table 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,.  
Line 71: Line 56:
*Override Row Label Width This option enables the space reserved for row labels to be fixed at a constant value. If the value is set non zero, then space for "n" characters is always used.This overrides the Table Editor’s Row parameter which enables the "Minimum Row Label Width" space to be specified. Unlike this option, the view specific parameter will always be used even if the labels are longer than the space allowed for.
*Override Row Label Width This option enables the space reserved for row labels to be fixed at a constant value. If the value is set non zero, then space for "n" characters is always used.This overrides the Table Editor’s Row parameter which enables the "Minimum Row Label Width" space to be specified. Unlike this option, the view specific parameter will always be used even if the labels are longer than the space allowed for.


<br>


=== Table 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.
== Visibility Control  ==


All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself.
The Run-Time visibility of a table view can be managed by setting up conditions in the condition editor.  
 
Broadcast Name Description of Event
 
*Cell Click Broadcast Transmitted when the user clicks on a cell to edit it, or after the user has edited a cell (with appropriate option set for the view).
*After Sort Broadcast Transmitted when the user performs a sort of the Table (with appropriate option set in the Table Editor).
*Scroll Broadcast Transmitted when the user scrolls the View of the Table.
 
<br>
 
=== 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.  
You can make references to the values of a range of other attributes.  
Line 97: Line 68:
<br>  
<br>  


=== Edit Original  ===
=== [[Category:Table]] [[Category:View]] [[Category:Training]] [[Category:~TBD]] ===
 
This is the option that displays the Table Editor Window.
 
Alternatively, double click on the Title of the Table View to display this window.
 
<br>
 
=== Copy  ===
 
Copies the View of this table and enables you to paste another View, with all the same settings, on another panel.
 
<br>
 
=== 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.
 
<br>
 
<br>
 
<br>
 
[[Category:Table]]
[[Category:View]]
[[Category:Training]]
[[Category:~TBD]]

Latest revision as of 19:54, 5 December 2012

Planimate tables can appear directly on panels along with objects in the model and paint buttons, making it possible to build comprehensive data input and display panels.

A number of types of table views exist, the most common being a grid of cells like the table editor. This view is described on this page. Other table view types include:

  • Cell Views for displaying/editing individual cells
  • Column Overlay Views which can graph multiple columns as multiple plots on one graph
  • Log Driven Views which create complex graphs using a number of pre-defined columns to control plotting position, colour, which overlay plot and other styles.
  • Gantt Views, optimised for drawing gantt charts including labels and linking lines
  • Train Graph Views, optimised for drawing line charts often used to visualise train motion between locations over time
  • Grid Views, a visualisation of a table as an array of icons or coloured pixels.

Basic Editing

A view of a table can be added to the current panel by selecting one of the options at the top of the View menubar in the Table Editor Window.

Multiple views of a given type can appear on a given panel so take care not to have a view covering another. They can be repositioned by dragging their title area or from the context menu.

Editing data in a table view is similar to editing in the table editor, however you can control which features are available using the Table View's Options and can take extreme control of the view's behaviour using click broadcasts. There are also additional graphics options for customising many colours in the view.

You can quickly access the original table for a view by double clicking on it.

Broadcasts

Certain interactions with Table Views can have Broadcasts associated with them, enabling the modeller to customise how the view responds when cells are clicked.

All View broadcasts are transmitted from the Scope of the Table, rather than the scope of the View itself.

Broadcast Name Description of Event

Cell Click Broadcast Transmitted when the user clicks on a cell to edit it, or after the user has edited a cell (with appropriate option set for the view).
After Sort Broadcast Transmitted when the user performs a sort of the Table (with appropriate option set in the Table Editor).
Scroll Broadcast Transmitted when the user scrolls the View of the Table.

Row Filters

Customised Column Views

Model Changes To Views

Customising

Selecting

Copy/Paste

Filtering

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.
  • Override Row Label Width This option enables the space reserved for row labels to be fixed at a constant value. If the value is set non zero, then space for "n" characters is always used.This overrides the Table Editor’s Row parameter which enables the "Minimum Row Label Width" space to be specified. Unlike this option, the view specific parameter will always be used even if the labels are longer than the space allowed for.


Visibility Control

The Run-Time visibility of a table 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.