SET-SUBITEM-DATA Action

This document covers the following topics:


Description

Updates the ("subitem") data for the specified list view item for the specified list view column(s).

The list view item handle may be specified as NULL-HANDLE, in which case the default data for the specified column(s) will be updated. The default data is the data returned by the GET-SUBITEM-DATA action in the case where no subitem data is present.

The column handle and data parameters may be repeated (in pairs), in order to allow the data for multiple columns to be updated in a single action.

The supplied data will be converted (if necessary) to the column's data FORMAT , with which it must therefore be MOVE -compatible.

For more information, please refer to the article Working with List View Controls.

Parameters

Name/Data Type Explanation
Item

(HANDLE OF GUI )

Input

Handle of list view item to be updated, or NULL-HANDLE if the default data for the specified list view column(s) should be updated.

Column

(HANDLE OF GUI )

Input

Handle of list view column to be updated. Cannot be specified as NULL-HANDLE.

Data

(any data type)

Input

Data to be written.

Response (I4) Output

Natural error (if applicable).

Example:

 
/* Example 1 - Updating of data for two columns in one action
PROCESS GUI ACTION SET-SUBITEM-DATA WITH #LVITEM-1
  #LVCOL-1 123 #LVCOL-2 'London' GIVING *ERROR
*
/* Example 2 - Set default data for column 3 (to -1)
PROCESS GUI ACTION SET-SUBITEM-DATA WITH NULL-HANDLE
  #LVCOL-3 -1 GIVING *ERROR