GetItemUnformattedString

method (DataWindows)

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 } )

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: True — Returns the original values (the values initially retrieved from the database). False — (Default) Returns the current values. 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")

1 2	String LName LName = dw_employee.GetItemUnformattedString(3, "emp_name")

See also

GetItemFormattedString

GetItemString

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 2017

August 20, 2023

Was this article helpful?