Label.property

Description

Settings for a DataWindow whose presentation style is Label.

Applies to

DataWindows

Syntax

PowerBuilder dot notation:

dw_control.Object.DataWindow.Label.property

Describe and Modify argument:

"DataWindow.Label.property { = value }"

SyntaxFromSql:

DataWindow(Label.property = value)

Parameter

Description

property

A property for the Label presentation style. Properties and their settings are listed in the table below.

value

The value to be assigned to the property. For Label properties, value cannot be a DataWindow expression.


Property for Label

Value

Columns

An integer indicating the number of columns of labels on a sheet.

Painter: Label group, Labels Across option.

Columns.Spacing

An integer indicating the space between columns of labels in the units specified for the DataWindow object.

Painter: Arrangement group, Between Columns option.

Ellipse_Height

An integer specifying the height of the rounded corners of a RoundRectangle label. This property is not valid for any other label shape. This value uses the same unit of measure specified for the DataWindow object.

Painter: Not set in painter.

Ellipse_Width

An integer specifying the width of the rounded corners of a RoundRectangle label. This property is not valid for any other label shape. This value uses the same unit of measure specified for the DataWindow object.

Painter: Not set in painter.

Height

An integer specifying the height of a label in the units specified for the DataWindow object.

Painter: Label group, Height option.

Name

A string containing the name of a label.

Painter: Predefined Label option.

Rows

An integer indicating the number of rows of labels on a sheet.

Painter: Label group, Labels Down option.

Rows.Spacing

An integer indicating the space between rows of labels on a sheet in the units specified for the DataWindow object.

Painter: Arrangement group, Between Rows option.

Shape

A string specifying the shape of a label.

Values are:

Rectangle

RoundRectangle

Oval

Painter: Not set in painter.

Sheet

(Describe only) Whether the paper is sheet fed or continuous.

Values are:

Yes -- Sheet fed

No -- Continuous

Painter: Arrangement group, Paper option.

TopDown

(Describe only) Whether the labels will be printed from the top to the bottom or across the page.

Values are:

No -- Print labels across the page.

Yes -- Print labels from top to bottom.

Painter: Arrangement group, Arrange option.

Width

An integer specifying the width of a label in the units specified for the DataWindow object.

Painter: Label group, Width option.


Usage

In the painter

Select the DataWindow object by deselecting all controls; then set the value in the Properties view, General tab (when presentation style is Label).

Examples

string setting
setting = dw1.Object.DataWindow.Label.Sheet
dw1.Object.DataWindow.Label.Width = 250
setting = dw1.Describe("DataWindow.Label.Sheet")
dw1.Modify("DataWindow.Label.Width=250")
dw1.Modify("DataWindow.Label.Height=150")
dw1.Modify("DataWindow.Label.Columns=2")
dw1.Modify("DataWindow.Label.Width=250")
dw1.Modify("DataWindow.Label.Name='Address1'")