SetColumnLink

Description

Establishes a link on a column that is passed from the database to the Web DataWindow control. This link lets the Web DataWindow DTC pass data to another page.

Applies to

PSDataWindowClass object

Syntax

PSDataWindowClassObject.SetColumnLink(columnName, link, linkArgs,
	linkTarget)

Argument	Description
columnName	A string that specifies the name of the column that you want to link to a target page.
link	A string that specifies the URL target of a link (HTML A element) from a data item in the column.
linkArgs	A string that specifies the arguments passed with the link argument. This string is appended to the link argument when the HTML is generated. This argument has the form: argname='exp' where “argname” is a page parameter that gets passed with the URL and “exp” is a DataWindow expression that gets evaluated. The value of the expression is converted using URL encoding.
linkTarget	A string that specifies the name of a target frame or window for the link specified in the link argument. The target is included in the HTML element using the HTML TARGET attribute. You can use linkTarget to link from a master to a detail page by specifying a different window or frame for the detail page.

Returns

None.

Usage

At runtime SetColumnLink sets up the link on the passed column. It allows you to make master and detail links easily from server scripts.

The behavior is the same for ASP and JSP Web targets.

Examples

Example 1

In the following example, the column called “emp_id” links to the file empdetail.htm, passing the “emp_id” as an argument:

htmlDwObj1.SetColumnLink("emp_id",
		"empdetail.stm","emp_id='emp_id'");