Border

Description

The type of border for the control.

Applies to

Column, Computed Field, Graph, GroupBox, OLE, Picture, Report, TableBlob, and Text controls

Syntax

PowerBuilder dot notation:

dw_control.Object.controlname.Border

Describe and Modify argument:

"controlname.Border { = ' value ' }"

SyntaxFromSql:

	Column ( ... Border = value ... )

	Text ( ... Border = value ... )

Parameter	Description
controlname	The name of the control whose border you want to get or set. When generating DataWindow syntax with SyntaxFromSql, the Border setting applies to all columns or all text controls.
value	(exp) A number specifying the type of border. Values are: 0 – None 1 – Shadow 2 – Rectangle 3 – Resize 4 – Line 5 – 3D Lowered 6 – 3D Raised The value can be a quoted DataWindow painter expression. When you change between Resize and another border, change the Resizeable property too so that the control’s appearance and behavior match. For columns, you can access the Border property with the GetBorderStyle and SetBorderStyle methods.

Parameter

Description

controlname

The name of the control whose border you want to get or set.

When generating DataWindow syntax with SyntaxFromSql, the Border setting applies to all columns or all text controls.

value

(exp) A number specifying the type of border.

Values are:

0 – None
1 – Shadow
2 – Rectangle
3 – Resize
4 – Line
5 – 3D Lowered
6 – 3D Raised

The value can be a quoted DataWindow painter expression.

When you change between Resize and another border, change the Resizeable property too so that the control’s appearance and behavior match.

For columns, you can access the Border property with the GetBorderStyle and SetBorderStyle methods.

Usage

In the painter

Select the control and set the value in the Properties view, General tab.Changing the Border setting between Resize and another border affects the Resizeable option on the Position tab. To make another border resizable, choose the border then reset Resizeable.

On Windows XP, to display the border of a text column with the XP style (by default, a blue box), set the Border property to Lowered and the BackgroundColor of the font to Window Background.

For a Picture in a Web DataWindow that is a link, the default border displays unless you set the Border property to 0.

For examples of other ways to set properties, using Border as an example, see “What you can do with DataWindow object properties”.

Examples

Example 1

string ls_data
ls_data = dw1.Object.emp_name_t.Border
dw1.Object.emp_name_t.Border='6'

Example 2

ls_data = dw1.Describe("emp_name_t.Border")

dw1.Modify("emp_name_t.Border='6'")

Example 3

SQLCA.SyntaxFromSQL(sql_syntax, &

		"Style(...) Column(Border=5 ...) ...", ls_Errors)