MenuLinkIter.next

Attempts to advance the iterator to the next (possibly first) link. TRUE is returned on success, or FALSE if there are no more links. You must call this function when you first acquire the iterator to advance it to the first link (and determine if the first link exists at all). Since 2.32 Signal Details The "items-changed" signal void user_function (GMenuModel *model, gint position, gint removed, gint added, gpointer user_data) : Run Last Emitted when a change has occured to the menu. The only changes that can occur to a menu is that items are removed or added. Items may not change (except by being removed and added back in the same location). This signal is capable of describing both of those changes (at the same time). The signal means that starting at the index position, removed items were removed and added items were added in their place. If removed is zero then only items were added. If added is zero then only items were removed. As an example, if the menu contains items a, b, c, d (in that order) and the signal (2, 1, 3) occurs then the new composition of the menu will be a, b, _, _, _, d (with each _ representing some new item). Signal handlers may query the model (particularly the added items) and expect to see the results of the modification that is being reported. The signal is emitted after the modification.

class MenuLinkIter
int
next
()

Return Value

Type: int

TRUE on success, or FALSE when there are no more links

Meta