SET-SUBITEM-DATA Action

#### Search Results

Search

# SET-SUBITEM-DATA Action

This document covers the following topics:

- Description

- Parameters

## 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

### On this page

- Description
- Parameters