Themes and Visual Classes

List_Box Properties

This table lists all the List_Box properties:

Note:
See Query Colors for information on applying color settings and Themes to a query display.

Property

Description

Attributes

Borderless

Control has no border or frame.

Disable Sorting

Clicking on the column heading does not cause list box elements to be sorted. The column headings will not have the 3D button look but will appear flat. Column resizing is still allowed.

(Disable Sorting property was added in PxPlus 2018.)

Attributes (ReportView)

Auto Column Size

When selected, columns will automatically be proportionally resized when the list box is resized. Default is Off.

(Auto Column Size property was added in PxPlus 2018.)

Center Text Vertically

When selected, text will be centered vertically in the list box row only when Lines Per Row is > 1. Text that exceeds the column width is truncated and an ellipsis (…) is displayed.

When this check box is not selected (Default), text is aligned to the top of the list box row, and text that exceeds the column width is word wrapped.

(Center Text Vertically property was added in PxPlus 2019.)

Column Size Lock

When selected, the report view column headers cannot be resized by dragging. Default is Off.

(Column Size Lock property was added in PxPlus 2018.)

Grid lines

Controls the display of grid lines between the rows and columns. Options are No lines (Default), Full grid, Vertical lines, Horizontal lines.

(Grid lines property was added in PxPlus 2018.)

Header Height

Controls the height of the header in report view lists in pixels.

Setting this property to -1 restores the height to its default size. Setting this property to 0 results in no header.

(Header Height property was added in PxPlus 2020.)

Header Lock

Locks the column headers so that the user is unable to click on them or drag them. Default is Off.

(Header Lock property was added in PxPlus 2018.)

Lines Per Row

Number of lines high per row. Valid values are >= 1. Allows for word-wrap. Can also be set to -1 to use the default lines per row for the list box.

(Lines Per Row property was added in PxPlus 2018.)
(Support to allow a setting of -1 was added in PxPlus 2024.)

Sort Options

Controls how column data is sorted. Click the drop-down arrow for available selections:

Default

Null values at end

None (Raw binary sort)

Ignore case/Nulls last

Ignore case

Ignore accents/Nulls last

Ignore accents

Ignore case & accents/Nulls last

Ignore case & accents

 

The Default setting will use the system StdSortOrder setting. See the 'OPTION' mnemonic or the 'SortOrder$ property.

(Sort Options property was added in PxPlus 2018.)

Colors

Click the dotted Query button or double click inside the cell to access Color Selections. Valid formats for color selections include predefined system colors (e.g. Light Red), Custom (RGB codes), HTML Hex Color Codes, User Defined colors (e.g. Color17) and string Expressions.

After a color property is set, a tick in the selected color displays in the top left corner. A floating tip with a sample of the selected color displays when hovering the mouse over the color setting.

(The color tick and color tip were added in PxPlus 2018.)
(The Color Selections Query button and dialog were added in PxPlus 2020.)

Background

Background color of the control in its default state.

Foreground

Foreground text color of the control in its default state.

Frame Color

Color of the frame/border around the control.

(Frame Color property was added in PxPlus 2024.)

Header Background Color

Sets the background color for the list view header.

(Header Background Color was added in PxPlus 2016.)

Header Text Color

Sets the color of the text for the list view header.

Header Text Color property was added in PxPlus 2016.)

Hilight Color 1

Background color - alternating lines.

(Hilight Color 1 property was added in PxPlus 2016.)

Hilight Color 2

Background color - alternating three lines.

(Hilight Color 2 property was added in PxPlus 2016.)

Hotlink Color

Color applied to the text of a column defined as a hotlink to provide a visual cue.

For information on defining a hotlink column, see Hotlink.

(Hotlink Color property was added in PxPlus 2018.)

Line Color

(Applicable to Report View and Tree View Only)

Color of the lines drawn between rows and columns of a report view list box or between entries of a tree view list box.

(Line Color property was added in PxPlus 2020.)

Colors (States)

Disable Background Color

Background color when the control is disabled.

(Disable Background Color property was added in PxPlus 2022.)

Disable Text Color

Foreground text color when the control is disabled. Not supported for list view.

(Disable Text Color property was added in PxPlus 2022.)

Focus Background Color

Background color when the control has focus.

(Focus Background Color property was added in PxPlus 2019.)

Focus Text Color

Text color when the control has focus.

(Focus Text Color property was added in PxPlus 2019.)

Hover Background Color

(Applicable to Report View Only)

Background color when the mouse is over a list view row.

(Hover Background Color property was added in PxPlus 2018.)

Font

Font

Click the dotted Query button or double click inside the cell to specify font properties and attributes such as Bold, Italics, etc.

Header Font

Defines the font for the list view header.

(Header Font property was added in PxPlus 2016.)

Other

iNomads Class

Assign an iNomads class to the control. The iNomads class contains class attribute references used when defining the control in the HTML code generated in iNomads. An iNomads class reference must start with an alpha character (A-Z or a-z), followed by any combination of A-Z, a-z, 0-9, underscore or dash. Multiple references may be entered, separated by a space.

For a list of pre-defined classes, see iNomads Classes.

(iNomads Class property was added in PxPlus 2020.)

See Also

VarList_Box Properties
Themes

Visual Classes