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

Example 1

string setting

setting = dw1.Object.DataWindow.Label.Sheet

dw1.Object.DataWindow.Label.Width = 250

Example 2

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'")