Warning: main(/www/www/htdocs/style/globals.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 1
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/globals.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 1
Warning: main(/www/www/htdocs/style/header.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 8
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/header.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 8
PtGenList item structure
typedef struct Pt_genlist_item {
unsigned flags;
PhDim_t size;
PtGenListItem_t *next, *prev;
} PtGenListItem_t;
This data structure describes an item in a
PtGenList widget.
|
Applications should view this as a read-only structure; subclasses
usually define ways to modify PtGenListItem_t members. |
The members include at least:
- flags
- The state of the item:
- Pt_LIST_ITEM_SELECTED
- This item is selected.
- Pt_LIST_ITEM_CURRENT
- This item is the current item
(see
“Current item”
in the description of PtGenList).
- Pt_LIST_ITEM_DAMAGED
- This item should be redrawn.
- Pt_LIST_ITEM_ABOVE
- This item is above the visible range of items. Use the
Pt_ARG_TOP_ITEM_POS
resource to scroll the list.
- Pt_LIST_ITEM_BELOW
- This item is below the visible range of items. Use the
Pt_ARG_TOP_ITEM_POS
resource to scroll the list.
- Pt_LIST_ITEM_INWIDGET
- The item has been added to a widget.
- Pt_LIST_ITEM_FLAG_USER1
Pt_LIST_ITEM_FLAG_USER2
Pt_LIST_ITEM_FLAG_USER3
Pt_LIST_ITEM_FLAG_USER4
- Flags that you can use for any purpose in your application.
The widgets don't use these flags.
The Pt_LIST_ITEM_USED_FLAGS macro defines the flags used by
the PtGenList widget. The remaining bits are available
for the child class.
It's safe to set only the following item flags before adding the item to
a widget — they're preserved if they don't conflict with the current
state of the widget:
- Pt_LIST_ITEM_SELECTED
- Preserved unless the selection mode is
Pt_SINGLE_MODE and another item is already selected.
- Pt_LIST_ITEM_CURRENT
- Preserved unless there's already a current item in the widget.
Don't modify these flags directly after the item is in a list; they're
set and cleared by the convenience functions.
- size
- A
PhDim_t
structure (see the Photon Library Reference) that defines
the width and height of the item.
If the widget has columns, the widths of the items are ignored.
- next, prev
- The widget uses these links to find the next and previous items
in the list.
Photon
PtGenList,
PtGenTree,
PtGenTreeItem_t,
PtList,
PtTreeItem_t
PhDim_t
in the Photon Library Reference
Building Custom Widgets
Warning: main(/www/www/htdocs/style/footer.php) [function.main]: failed to open stream: No such file or directory in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 204
Warning: main() [function.include]: Failed opening '/www/www/htdocs/style/footer.php' for inclusion (include_path='.:/www/www/common:/www/www/php/lib/php') in /www/www/docs/6.4.1/photon/widget_ref/ptgenlistitem_t.html on line 204