Graphisoft®

Dialog ManagerVersion: 2.0

DGListSetItemText

Sets the text of a list box item. This function is obsolete use DGListSetTabItemText instead.

    void DGListSetItemText (
      short        dialId,
      short        item,
      short        listItem,
      const char*  text
    );

Parameters

dialId
ID of the dialog or tab page. DG_TOP_MODAL specifies the topmost modal dialog.
 
item
1-based index of the dialog item.
 
listItem
1-based index of the list item. DG_LIST_TOP specifies the first item of the list, DG_LIST_BOTTOM specifies the last item of the list.
 
text
Pointer to the new text of the item.

Remarks

A separator line cannot have item text.

The item text should not contain end-of-line characters.

DGListSetItemText sets the text of the whole list row. If the list box control has more tabulator fields (columns), the text of tabulator fields is delimited by tabulator ('\t') characters.

Use DGListSetTabItemText to set tabulator item text. A tabulator item can contain icon also, see DGListSetTabItemIcon and DGListSetTabItemIconId for details.

Requirements

Version: DG 2.0.0 or later
Header: DG.h
Import Library: DG.lib [WIN]
Module: DGLib [MAC], DG.dll [WIN]

See Also

DG Functions, List Box
DGListSetTabItemText, DGListGetTabItemText, DGListSetTabItemIcon, DGListSetTabItemIconId