PtFSAddFirst()

Add a root item to a file selector tree

Synopsis:

void PtFSAddFirst( PtWidget_t *fs, 
                   PtFileSelItem_t *item,
                   PtFileSelItem_t *parent );

Description:

This function adds a list of items linked with the brother field. The parent argument identifies the parent item for the added items. The new items are added in front of any existing children of the parent item.

The parent argument may also be NULL, in which case the item is added at the root level of the file selector before any existing items at the root level. This is what happens when the Pt_ARG_FS_ROOT_DIR resource is set.

The results of using PtFSAddFirst().

You can call this function with a NULL fs argument, as long as parent points to an item that isn't attached to any file selector widget.

PtFSAddFirst() automatically sets the Pt_TREE_ITEM_EXPANDABLE flag in the parent item.

Classification:

Photon

See also:

PtFSAddAfter(), PtFSRootItem()