PtTreeModifyItem()

Change item resources

Synopsis:

PtTreeItem_t *PtTreeModifyItem( PtWidget_t *tree, 
                                PtTreeItem_t *item, 
                                const char *string,
                                short sel_img, 
                                short unsel_img );

Description:

This function changes item resources.

• The item's string is copied from string. If string==NULL, the item's string isn't changed.
• The set_img argument is the index of the image that's displayed when the item is set, and unset_img is the image displayed when it isn't set. An item is considered set if its flags masked with the Pt_ARG_TREE_IMGMASK resource of the widget give a nonzero value.

Don't use this function to modify an item that hasn't yet been added to the tree.

Returns:

The new address of the item.

This address may differ from the old one if the new string is longer.

Classification:

Photon

See also:

PtTree, PtTreeAllocItem(), PtTreeItem_t, PtTreeItemIndex()