DataStore object
A DataStore is a nonvisual DataWindow control. DataStores
act just like DataWindow controls except that many of the visual
properties associated with DataWindow controls do not apply to DataStores.
Because you can print DataStores, PowerBuilder provides some events
and functions for DataStores that pertain to the visual presentation
of the data.
However, graph functions such as CategoryCount, CategoryName, GetData, SeriesCount,
and so forth depend on the visual graph control, which is not created
for a DataStore object. These functions return an error value or
an empty string when used with DataStores.
Properties
DataStore property |
Datatype |
Description |
---|---|---|
DataObject |
String |
Specifies the name of the DataWindow |
ClassDefinition |
PowerObject |
An object of type PowerObject containing |
Object |
DWObject |
Used for the direct manipulation of objects |
Events
Some but not all DataStore events have return codes that you
can use to determine what action will be taken after the event occurs.
You set the return codes in a RETURN statement
in the event script.
DataStore event |
Occurs |
---|---|
Immediately before the Open event occurs |
|
When a database error occurs in the DataStore. Return codes:
|
|
Immediately after the Close event occurs |
|
When an error is found in a data or property |
|
When the AcceptText and Update functions Return codes:
|
|
When a value imported into a DataStore Return codes:
If the return code is 0 or 1 (rejects the data), the field |
|
When the printing of the DataStore ends. |
|
Before each page of the DataStore is Return codes:
|
|
When the printing of the DataStore starts. |
|
When the retrieval for the DataStore |
|
After a row has been retrieved. Return codes:
|
|
When the retrieval for the DataStore Return codes:
|
|
After a Retrieve, Update, The following return codes specify the action that takes place
|
|
When all the updates from the DataStore |
|
After an Update function Return codes:
|
Functions
DataStore function |
Datatype returned |
Description |
---|---|---|
Integer |
Applies the contents of the DataStore’s |
|
Integer |
Returns the number of categories in the |
|
String |
Returns the name of the specified category |
|
String |
Returns the name assigned to the DataStore. |
|
Integer |
Deletes all items from the value list |
|
Integer |
Copies the specified graph in the DataStore |
|
String |
Returns the selected text, pictures, |
|
Integer |
Creates a DataWindow object using the |
|
Integer |
Creates a DataStore object from the passed |
|
Long |
Returns the number of data points in |
|
Integer |
Cancels a database retrieval in progress. |
|
Long |
Returns the number of rows that have |
|
Integer |
Deletes the specified row from the DataStore. |
|
String |
Returns requested information about the |
|
Integer |
Moves rows that do not meet the current |
|
Integer |
Returns the number of rows that do not |
|
Long |
Returns the number of the first row that |
|
Integer |
Returns the number of the specified category |
|
Long |
Searches starting at a specified row |
|
Integer |
Identifies the required columns that |
|
Integer |
Returns the number of the specified series |
|
Integer |
Creates an HTML Form element containing |
|
Long |
Returns an EAServer result |
|
Border (enumerated) |
Returns a Border enumerated datatype
|
|
Long |
Retrieves changes made to a DataStore |
|
Integer |
Stores in the specified variable the |
|
Integer |
Obtains the number of the column the |
|
Long |
Obtains the number of the row the user |
|
Integer |
Returns the number of the current column |
|
String |
Returns the name of the current column |
|
Integer |
Creates a reference to a context-specific |
|
Double |
Returns the value of the specified data |
|
Integer |
Reports the percentage that a pie slice |
|
Integer |
Finds out the appearance of a data point |
|
Integer |
Returns the value of the specified data |
|
String |
Returns the format used for display in |
|
Long |
Retrieves the complete state of a DataStore |
|
Date |
Returns the date data in the specified |
|
DateTime |
Returns the datetime data in the specified |
|
Decimal |
Returns the decimal data in the specified |
|
Double |
Returns the numeric data in the specified |
|
dwItemStatus (enumerated) |
Returns the status of the item at the
|
|
String |
Returns the string data in the specified |
|
Time |
Returns the time data in the specified |
|
Long |
Returns the number of the first row that |
|
PowerObject |
Returns a reference to the name of the |
|
Long |
Returns an integer containing the number |
|
Long |
Gets the row number of a row in a DataStore |
|
Long |
Gets the unique row identifier of a row |
|
Integer |
Returns the number of the first selected |
|
Integer |
Finds out the appearance of a series |
|
String |
Returns the current SELECT statement |
|
Long |
Retrieves the current status of the internal |
|
String |
Returns the text in the edit control |
|
Integer |
Returns the values in the DataStore Transaction |
|
String |
Returns the validation rule used in the |
|
String |
Returns the specified item in the value |
|
Integer |
Recalculates the breaks in the groups |
|
Long |
Copies data from the clipboard to the |
|
Long |
Copies data from a file to the DataStore. |
|
Long |
Copies data from a string to the DataStore. |
|
Integer |
Inserts a rich text format or plain text
This function applies only to DataStores whose content has |
|
Long |
Inserts a new initialized row before |
|
Boolean |
Returns true if the |
|
Long |
Returns the number of rows that have |
|
String |
Uses the specification contained in a |
|
Long |
Pastes rich text data from a string into |
|
Boolean |
Adds an event to the end of the message |
|
Integer |
Sends the content of the DataStore to |
|
Integer |
Cancels the print job and deletes the This function has two syntaxes. Use Syntax 1 when Syntax 1 |
|
Integer |
Accesses the database to reselect all |
|
Integer |
Clears all the data from a DataStore. |
|
Integer |
Resets the color of a data point to the |
|
Integer |
Stops the DataStore from using a programmer-defined Transaction |
|
Integer |
Resets the update flags for the DataStore. |
|
Long |
Causes the DataStore to retrieve rows |
|
Long |
Returns the number of rows currently |
|
Integer |
Copies a range of rows from one DataStore |
|
Integer |
Discards a range of rows. The rows cannot |
|
Integer |
Clears a range of rows from a DataStore |
|
Integer |
Saves the content of the DataStore to |
|
Long |
Saves the content of a DataStore into |
|
Integer |
Selects or deselects the specified row |
|
Integer |
Returns the number of series in the specified |
|
String |
Returns the name of the specified series |
|
Integer |
Sets the border style of the specified |
|
Long |
Applies changes captured with GetChanges to |
|
Integer |
Makes the specified column the current |
|
Integer |
Explodes a pie slice in a pie graph. |
|
Integer |
For the specified data point in the specified |
|
Integer |
Sets the height of each row in a specified |
|
Integer |
Defines the filter criteria for the DataStore. |
|
Integer |
Sets the display format for the specified |
|
Long |
Applies the contents of a DataWindow |
|
Integer |
Accepts action and context information |
|
Integer |
Sets the value of the specified row and |
|
Integer |
Sets the status of a row in a specified |
|
Integer |
Moves an object within the DataStore |
|
Integer |
Makes the specified row the current row |
|
Integer |
For the specified series in the specified |
|
Integer |
Defines the sort criteria for the DataStore. |
|
Integer |
Sets the current SQL statement |
|
Integer |
Changes the current SELECT statement |
|
Integer |
Replaces the text in the edit control |
|
Integer |
Sets values in the DataStore’s |
|
Integer |
Sets the Transaction object for the DataStore |
|
Integer |
Changes the validation rule used for |
|
Integer |
Sets the value of the specified item |
|
Integer |
Causes a DataStore (or DataWindow control) |
|
Integer |
Shares data between a primary DataStore |
|
Integer |
Turns off sharing for the DataStore. |
|
Integer |
Sorts the rows of the DataStore based |
|
Integer |
Triggers a specified event in the DataStore |
|
Object |
Returns the type of the DataStore. |
|
Integer |
Sends to the database all inserts, deletes, |