13.3.5.2 Customizing the GridLogView Display

In addition to the general customization variables available on the GridLogView object, the DT_GraphLogViewSpec and GraphLogViewSpec objects allow precise control over the positioning and display style of the data elements in the GraphLogView.

Each of the columns of data in the PDPLog has an associated GridLogViewSpec in the GridLogView. Some of the columns of data have been grouped together by their generating statistics and will also have a DT_GridViewSpec for the entire group of data columns.

The GridLogViewSpec provides the following customizable variables:

TDGeometry pos
Indicates the position in the grid in which this data column's values will appear. If the GridLogViewSpec is part of an associated group of GridLogViewSpecs this variable will indicate the relative offset of this column's value from the position of the DT_GridViewSpec associated the the group. The Z component of the position is ignored. (0,0) is in the upper left corner of the GridLogView.
DisplayStyle display_style
Controls the way in which the Log data values for this column are displayed. The choices are:
TEXT
Display the values as text only
BLOCK
Display the values as a colored block
TEXT_AND_BLOCK
Display the block overlaid with with text

For data columns organized into groups, the DT_GridViewSpec provides the following variables:

TDGeometry pos
Indicate the position in the grid in which this group of data columns' values will appear. The Z component of the position is ignored. (0,0) is in the upper left corner of the GridLogView.
TDGeometry geom
Controls the size of the region in which the GridViewSpecs of the this DT_GridViewSpec are positioned.
Bool use_gp_name
When this variable is set to true a single label of the name of the group's DT_GridViewSpec is used instead of individual labels for all the GridViewSpecs of the group.
DisplayStyle display_style
Controls how the GridViewSpecs are positioned in the geom sized region of DT_GridViewSpec. The possible values along with a 3x3 example are:
LFT_RGT_BOT_TOP
Increment column first, then decrement row, start at bottom left:
 789
 456
 123
LFT_RGT_TOP_BOT
Increment column first, then increment row, start at top left:
 123
 456
 789
BOT_TOP_LFT_RGT
Decrement row first, then increment column, start at bottom left:
 369
 258
 147
TOP_BOT_LFT_RGT
Increment row first, then increment column, start at top left:
 147
 258
 369

The DT_GridViewSpec provides the following functions:

UpdateLayout(MatrixLayout ml)
Repositions the GridViewSpecs according to the ml and the geom variable.