Progress
Language Reference


DELETE( ) Method

Deletes an item from a combo box, radio-set, or selection list.

Return Type: LOGICAL

Applies To: Combo-box, Radio-set, Selection-list

Combo-box and Selection-list Syntax:
DELETE ( list-index | list-item ) 

list-index

An INTEGER expression that specifies the ordinal position of a value in the combo box list or selection list.

list-item

A character-string expression that specifies a single value or a delimiter-separated list of values in the widget.

The DELETE( ) method removes the item specified by list-index, or removes the specified list-item from the list. list-item can represent multiple items. For example, you might specify DELETE( "Chicago, Boston, New York" ), where the delimiter is a comma. The delimiter is a comma by default or is specified by the DELIMITER attribute. If the method is successful, it returns TRUE.

Radio-set Syntax:
DELETE ( label ) 

label

A character-string expression that specifies an item to delete from the radio-set.

The DELETE( ) method deletes the item from the radio-set, whose appearance changes depending on the user interface and the setting of the AUTO-RESIZE attribute. For all user interfaces, if AUTO-RESIZE is TRUE, the remaining items collapse toward the top to fill the gap left by the deleted item. If AUTO-RESIZE is FALSE on Windows, the remaining items are repositioned to evenly span the original radio-set dimensions; in character interfaces, the remaining items collapse upward as when AUTO-RESIZE is TRUE. If the method is successful, it returns TRUE.

NOTE: A single call to DELETE can delete one or more items from a combo box or selection list, or one item from a radio set.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095