Description
Gets raw (unformatted) data whose type is String from the specified buffer of a DataWindow control or DataStore object.
Applies to
DataWindow type |
Method applies to |
---|---|
PowerBuilder |
DataWindow control, DataWindowChild object, DataStore object |
Syntax
PowerBuilder
string dwcontrol.GetItemUnformattedString ( long row, integer column {, DWBuffer dwbuffer, boolean originalvalue } ) string dwcontrol.GetItemUnformattedString ( long row, string column {, DWBuffer dwbuffer, boolean originalvalue } )
Argument |
Description |
---|---|
dwcontrol |
A reference to a DataWindow control, DataStore, or child DataWindow. |
row |
A value identifying the row location of the string data. |
column |
The column location of the data. The datatype of the column must be String. Column can be a column number or a column name. The column number is the number of the column as it is listed in the Column Specification view of the DataWindow painter -- not necessarily the number of the column in the Design view. To get the contents of a computed field, specify the name of the computed field for column. Computed fields do not have numbers. |
dwbuffer (optional) |
A value of the dwBuffer enumerated datatype identifying the DataWindow buffer from which you want to get the data. For a list of valid values, see DWBuffer. |
originalvalue (optional) |
A boolean indicating whether you want the original or current values for row and column:
If you specify dwbuffer, you must also specify originalvalue. |
Usage
Use GetItemUnformattedString in place of GetItemString when you want to return the value from a column without its display format. This is especially useful if the column in question is a computed column.
Examples
These statements set LName to the current string in the primary buffer for row 3 of in the column named emp_name in the DataWindow dw_employee. The retrieved value is unformatted:
String LName LName = dw_employee.GetItemUnformattedString(3, "emp_name")
See also