Graphisoft®

Dialog ManagerVersion: 2.0

DGSetItemData

This function is obsolete.

Sets the user-specified data of a user control dialog item.

    void DGSetItemData (
      short        dialId,
      short        item,
      const void*  userData,
      Int32        offset,
      Int32        size
    );

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.
 
userData
Pointer to the new user data block.
 
offset
0-based offset in the user data block.
 
size
Number of bytes to set in the user data block, beginning at offset.

Remarks

Every user control can have a block of data describing the visual appearance and the behavior of the item. Moreover, the application can store any other information in this block. DG makes a copy of userData so the application can free its memory after calling DGSetItemData.

DG automatically allocates and resizes memory blocks if necessary so the data block can be enlarged by setting (offset + size) larger than the current size of the item data field.

Requirements

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

See Also

DG Functions, User Control, DGGetItemData