w3mvDInsert

Syntax   Parameters   Example Programs   Example

w3mvDInsert sets the value of an mvDesigner column.  

Syntax

call w3mvDInsert  (ColumnName , ColumnValue , ValueProperties )  

Parameters

ColumnName

In

Multi-attribute list of mvDesigner column names to set. If a column is part of an mvDesigner grid or table, the column name must specify the grid or table name and the column name within the grid or table. The grid/table name is separated from the column name by a period. For example: address.city for the city column in the address grid. Within a column name periods can only used to separate the grid/table name from the column name.

ColumnValue

In

Multi-attribute, multi-valued list of values for each ColumnName. Each attribute in the ColumnValue parameter is associated with the same attribute in the ColumnName parameter. Each value is a separate value for the ColumnName associated with the ColumnValue. ColumnValues without an associated ColumnName are ignored. Use of sub-value results in unpredictable results.

ValueProperties

In

Multivalued attribute, multivalued list of properties for each ColumnValue. Each value in the ValueProperties parameter is associated with the same value in the ColumnValue parameter. If not specified, the ValueProperty is set to no special properties. Support for this field is dependent upon the mvDesigner Object displaying the values. Some Objects support selecting multiple values, some only one, some none. "0" or "" indicate no properties are set.

The currently supported properties are:

p_UCV_FOCUS

The specified value is set as the current field. This is the same as setting the focus on this field. Support for this property is dependent upon the mvDesigner object receiving the value. Some Objects support setting focus, some do not. If this property is set for an object which does not support focus, the property is ignored. To set both properties, add the two values together.

p_UCV_SELECTED

The specified value is displayed as selected. Support for this property is dependent upon the mvDesigner Object displaying the value. Some objects support selecting multiple values, some only one, some none. If this property is set for an object which does not support selecting, then the property is ignored. If multiple values are selected for an object which only supports one selected value, one of the specified values is selected, the others are not selected.  

Example Programs

mvD.Test2

mvDCompile

w3admin.w3apps

w3mvDTimeoutTest

mvDEchoP

w3mvDDiscardEventTest

persistentConnection

w3mvDTestSelection

mvDEcho

w3mvDProgressTest

w3mvDPopUpTest

mvDId

EchomvD

mvD.Test1

Example

call w3mvDInsert("Address", "1234 AnyStreet", p_UCV_FOCUS + p_UCV_SELECTED)

call w3mvDInsert("Address", "1234 AnyStreet", "")

call w3mvDInsert("Address", "1234 AnyStreet", 0)