get_next
Description:
This function combines next with get_name and get_value.
First the iterator is advanced to the next (possibly first) link. If that fails, then false is returned and there are no other effects.
If successful, out_link
and value
are set to the name and
MenuModel of the link that has just been advanced to. At this point,
get_name and
get_value will return the same values again.
The value returned in out_link
remains valid for as long as the iterator remains at the current position. The value returned in
value
must be unreffed using unref when it is no longer in use.
Parameters:
this | |
out_link |
the name of the link |
value |
the linked MenuModel |
Returns:
true on success, or false if there is no additional link |