Chapter 3: DataWindow Object Properties

Format

Description

The display format for a column.

You can use the GetFormat and SetFormat functions instead of Describe and Modify to get and change a column’s display format. The advantage to using Modify is the ability to specify an expression.

Applies to

Column and Computed Field controls

Syntax

PocketBuilder dot notation:

dw_control.Object.controlname.Format

Describe and Modify argument:

"controlname.Format { = ' value ' }"

Parameter	Description
controlname	The name of the column or computed field for which you want to get or set the display format.
value	(exp) A string specifying the display format. See the User’s Guide for information on constructing display formats. Value can be a quoted DataWindow expression.

Usage

In the painter

Select the control and set the value in the Properties view, Format tab.

Examples

Example 1

setting = dw_1.Object.phone.Format

Example 2

dw_1.Object."phone.Format = "[red](@@@)@@@-@@@@;'None'"

Example 3

setting = dw_1.Describe("phone.Format")

Example 4

dw_1.Modify( &

"phone.Format='[red](@@@)@@@-@@@@;~~~'None~~~''")