PSWebDataWindowClass

Objects of this class are server-side representations of Web DataWindow controls on 4GL Web pages. For non-4GL Web pages, use PSDataWindowClass objects instead.

Syntax

PSWebDataWindowClass(objectName, ServerSideStateManagement, jaguarConnection, sourceLocation, dbConnection, {lPageSize})

Constructors

PSWebDataWindowClass constructor	Datatype	Description
objectName	String	The name of the client-side control. By default, the name is set to dw_1.
ServerSideStateManagement	boolean	Specifies where the database state is managed: true The server manages the database state. A reference to the server component is saved and retrieved from the session object (based on the name of the Web DataWindow object). false (default) The client manages the database state.
jaguarConnection	String	The connection information needed to connect to EAServer. An EAServer profile must be defined.
sourceLocation	String	The location of the DataWindow object. If this property is null (default), the server component must encapsulate the identity of the source.
dbConnection	String	The database connection properties. If this property is null (default), the server component must encapsulate the database connection properties.
lPageSize (optional)	String	A positive integer specifies the number of rows that will be passed to, and therefore contained in, the Web DataWindow control.

Events

PSWebDataWindowClass event	Description
AfterAction	Triggered just after the call to SetAction on the server component
AfterRetrieve	Triggered just after the call to Retrieve on the server component
AfterUpdate	Triggered just after the call to Update on the server component
BeforeAction	Triggered just before SetAction is called on the server component
BeforeRetrieve	Triggered just before Retrieve is called on the server component
BeforeUpdate	Triggered just before Update is called on the server component
OnDBError	Triggered if a database error occurs during processing
Validate	Triggered immediately after the context is restored in the server component
ValidationError	Triggered if the webdw.Validate event fails

Methods

See the DataWindow Reference for more information about these methods:

PSWebDataWindowClass method	Description
ClearValues	Deletes all items from a value list or code table associated with a DataWindow column
Create	Creates a DataWindow object using DataWindow source code and puts that object in the specified DataWindow control
DeletedCount	Reports the number of rows that have been marked for deletion in the database
DeleteRow	Deletes a row from the DataWindow control
Describe	Reports the values of properties of a DataWindow object and controls within the DataWindow object
Filter	Displays rows in a DataWindow that pass the current filter criteria
FilteredCount	Reports the number of rows that are not displayed in the DataWindow because of the current filter criteria
Find	Finds the next row in a DataWindow in which data meets a specified condition
FindGroupChange	Searches for the next break for the specified group
Generate	Generates the DataWindow as HTML
GenerateXHTML	Generates the DataWindow as XHTML
GenerateXMLWeb	Generates the DataWindow as XML
GetColumn	Obtains the number of the current column
GetColumnName	Obtains the name of the current column
GetFormat	Obtains the display format assigned to a column in a DataWindow control
GetItemDate	Gets data of type Date from the specified buffer of a DataWindow control
GetItemDateTime	Gets data of type DateTime from the specified buffer of a DataWindow control
GetItemFormattedString	Gets and formats data of type String from the specified buffer of a DataWindow control or DataStore object.
GetItemNumber	Gets numeric data from the specified buffer of a DataWindow control
GetItemStatus	Reports the modification status of a row or a column within a row
GetItemString	Gets data of type String from the specified buffer of a DataWindow control
GetItemTime	Gets data of type Time from the specified buffer of a DataWindow control
GetItemUnformattedString	Gets unformatted data of type String from the specified buffer of a DataWindow control or DataStore object.
GetRow	Reports the number of the current row in a DataWindow control
GetValidate	Obtains the validation rule for a column in a DataWindow
GetValue	Obtains the value of an item in a value list or code table associated with a column in a DataWindow
GroupCalc	Recalculates the breaks in the grouping levels in a DataWindow
ImportString	Inserts data into a DataWindow control from tab-delimited data in a string
InsertRow	Inserts a row in a DataWindow
ModifiedCount	Reports the number of rows that have been modified but not updated in a DataWindow
Modify	Modifies a DataWindow object by applying specifications (given as a list of instructions) that change the DataWindow object’s definition
ReselectRow	Accesses the database to retrieve values for all columns that can be updated and refreshes all timestamp columns in a row in a DataWindow control
Reset	Clears all the data from a DataWindow control
ResetUpdate	Clears the update flags in the primary and filter buffers and empties the delete buffer of a DataWindow
Retrieve	Retrieves rows from the database for a DataWindow control
RowCount	Obtains the number of rows that are currently available in a DataWindow control
RowsDiscard	Discards a range of rows in a DataWindow control
SaveAs	Saves the contents of a DataWindow in the format you specify
SetColumn	Sets the current column in a DataWindow control
SetColumnLink	Specifies information used for constructing hyperlinks for data in a column in generated HTML
SetDetailHeight	Sets the height of each row in the specified range to the specified value
SetDWObject	Specifies the DataWindow library and object that the Web DataWindow server component will use for generating HTML
SetFilter	Specifies filter criteria for a DataWindow control
SetFormat	Specifies a display format for a column in a DataWindow control
SetItem	Sets the value of a row and column in a DataWindow control to the specified value
SetItemDate	Sets the value of a row and column in a DataWindow control to the specified value
SetItemDateTime	Sets the value of a row and column in a DataWindow control to the specified value
SetItemNumber	Sets the value of a row and column in a DataWindow control to the specified value
SetItemStatus	Changes the modification status of a row or a column within a row
SetItemString	Sets the value of a row and column in a DataWindow control to the specified value
SetItemTime	Sets the value of a row and column in a DataWindow control to the specified value
SetPosition	Moves a control within the DataWindow to another band or changes the front-to-back order of controls within a band
SetRow	Sets the current row in a DataWindow control
SetServerServiceClasses	Tells the server component to trigger custom events defined in user objects for data validation
SetSort	Specifies sort criteria for a DataWindow control
SetSQLSelect	Specifies the SQL SELECT statement for a DataWindow control
SetValidate	Sets the input validation rule for a column in a DataWindow control
SetValue	Sets the value of an item in a value list or code table for a column in a DataWindow control
SetWeight	Specifies the types of JavaScript code that will be included in the generated HTML
Sort	Sorts the rows in a DataWindow control using the DataWindow’s current sort criteria
Update	Updates the database with the changes made in a DataWindow control