SetDWObject

Description

Specifies the DataWindow library and object that the Web DataWindow server component will use for generating HTML.

NoteSetDWObjectEx A separate method name is provided as an alternative syntax for specifying DataWindow objects in a PBD generated by the Web DataWindow Component project wizard. Because it is already included in its own library list property, the PBD component does not take an argument for a source file name. The generated PBD also includes a reference to the DataWindow HTML generator that it implements as an interface.

Applies to

DataWindow type

Method applies to

Web

Server component

Syntax

Web DataWindow server component

int dwcomponent.SetDWObject ( string sourcefile, 
       string dwobjectname )
int dwcomponent.SetDWObjectEx ( string dwobjectname )

Argument

Description

dwcomponent

A reference to a Web DataWindow server component.

sourcefile

The name of a PowerBuilder library (PBL) or dynamic library (PBD) containing DataWindow object definitions

or

A source definition file (SRD)

or

A Powersoft report (PSR) containing a DataWindow object definition and data.

The file must be located in the file system of the machine hosting the server component.

dwobjectname

When sourcefile is a PBL or PBD, the name of a DataWindow object in the library.

When sourcefile is a PSR or SRD, dwobjectname should be an empty string (“”).

Returns

Returns 1 if it succeeds and –1 if an error occurs.

Usage

For information about using the Web DataWindow, see the DataWindow Programmers Guide.

Examples

Example 1

This example identifies the library and DataWindow object for the server component called dwGen:

int retVal = dwGen.SetDWObject("htgenex.pbl",

		"d_tabular_dept")

See also