This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PtTreeModifyItem()

Change item resources

Synopsis:

PtTreeItem_t *PtTreeModifyItem( PtWidget_t *tree, 
                                PtTreeItem_t *item, 
                                const char *string,
                                short set_img, 
                                short unset_img );

Description:

This function changes item resources:

• The item's string is changed to be a copy of string. If string is 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.

The tree is a pointer to the PtTree that the item belongs to, or NULL. If the item is in a tree, it must be in the one pointed to by 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(), PtTreeModifyItemString()