DELETE-SUBITEM-DATA Action

This document covers the following topics:


Description

Deletes 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 deleted. 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 parameter may be repeated, in order to allow the data for multiple columns to be deleted in a single action.

Note that this action cannot be used to delete the data for the primary column (i.e., the column used to display the list view item labels).

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 whose data is to be deleted, or NULL-HANDLE if the default data for the specified list view column(s) should be deleted.

Column

(HANDLE OF GUI )

Input

Handle of list view column whose data is to be deleted. Cannot be specified as NULL-HANDLE.

Response (I4) Output

Natural error (if applicable).

Example:

PROCESS GUI ACTION DELETE-SUBITEM-DATA WITH #LVITEM-1 #LVCOL-2 #LVCOL-3 #LVCOL-4 GIVING #RESPONSE