Counts the widgets contained by an application objectint sm_list_objects_count(int list_id);
- An integer handle to the list of widgets in an application object, obtained from sm_list_objects_start.
sm_list_objects_countreturns the number of objects specified in an object contents list. This list, created by sm_list_objects_start, initially contains the object IDs of all widgets in the container object; thus, a call to
sm_list_objects_countimmediately after the list is created yields the total number of widgets in a container object. Each call to sm_list_objects_next reduces by one the number of objects in the list; so a call to
sm_list_objects_countthat is preceded by calls to
sm_list_objects_nextyields the number of objects that remain on the object contents list.
sm_list_objects_countdoes not check whether the widgets in an object contents list are still in existence; it is therefore possible to return a count that includes invalid object IDs for widgets that were destroyed after the list's creation.