DataWindows – PB Docs 2019

When “background-color-enabled” is true in the theme
file, the background color in the theme file takes effect;
when “background-color-enabled” is false in the theme file,
the background color in the painter takes effect.

For the background color and font color of Column, Text,
Computed Field, and GroupBox controls, the settings in the
expression or the Modify method have higher priorities than
the theme file. The settings in the painter have no
effect.

For the Header of Grid and CrossTab DataWindows, the
background of the Text control is transparent and the
background color of the Header band is determined by the theme
file.

For the DataWindow border property, the settings in the
painter have higher priorities than the theme file.
Dynamically setting the border property at runtime in the
script will not take effect.

When the TitleBar property is disabled and the Border
property is enabled in the painter, border is rendered using
the settings in the theme file; when both the TitleBar
property and the Border property are disabled in the painter,
no border is rendered (the theme file has no effect to the
DataWindow title bar as well as its border).

For controls in the DataWindow object, when “border”=0
in the theme file, the visibility of the border is determined
by the Border setting in the painter; if the Border setting is
selected in the painter, the border is displayed (with the
style of StyleBox!) and the border color can be set in the
theme file; when “border”=1 in the theme file, controls in the
DataWindow object will have StyleBox! border, regardless of
the border settings in the painter; when “border”=2 in the
theme file, controls in the DataWindow object will not have
border, regardless of the border settings in the
painter.

For the Resizable property, the settings in the painter
have higher priorities than the theme file: when enabled in
the painter, DataWindow is not flattened; when disabled in the
painter, DataWindow is flattened. Dynamically setting the
Resizable property at runtime in the script will not take
effect.

The controls in the DataWindow are configured
respectively in the theme file, except for the Column, Text
and Computed Field controls in the Grid and Crosstab
DataWindow which are configured under the “grid-style” and
“cross-style” in the theme file.

The DataWindow selected row is determined by the theme
file, which are configured under the “cross-style” for the
Crosstab DataWindow, or configured under the “grid-style” for
DataWindows of other presentation styles.

The theme is not effective to the DataWindow with the
following presentation style: Label, Composite, OLE 2.0, and
RichText.

The theme is not effective to the DataWindow title
bar.

The theme is not effective to the DataWindow Button
control if the button displays a picture (system picture or
custom picture).

If a DataWindow control is dynamically created, it will
be first rendered by the theme file (rather than the
definition in the Create statement), or changed later by the
property expression in the painter or the Modify method in the
script.

The color of the DataWindow band (except for the Header
of Grid and Crosstab DataWindows) is not configurable in the
theme file; it is determined by the settings in the
painter.

When printing or saving the DataWindow as PDF file, the
theme will not take effect, except for the Graph
DataWindow.

The border style is always StyleBox!. The following
border styles are unsupported: StyleLowered!, StyleRaised!,
and StyleShadowBox.

The CheckBox and RadioButton control on a DataWindow
Column will have no border.

The font related properties (except font color) cannot
be set by the theme file.

If DataWindow HSplitScroll is set to true, the height of
HScrollBar groove and the width of VScrollBar groove cannot be
set by the theme file; they will have no effect and will use
the default values.