Package: gtk

Function gtk-notebook-add-page

Lambda List

gtk-notebook-add-page (notebook child tab &key position menu)

Arguments

notebook -- a gtk-notebook widget
child -- a gtk-widget child widget to use as the content of the page
tab -- a gtk-widget object to use as the label for the page, or nil to use the default label, 'page N'
position -- an integer with the index starting at 0 at which to insert the page, or -1 to append the page after all other pages, or :end to append the page, :start to prepend the page, the default value is :end
menu -- a gtk-widget object to use as a label for the page-switch menu, if that is enabled

Return Value

An integer with the index starting from 0 of the added page in the notebook, or -1 if the function fails.

Details

Inserts a page into the notebook depending on the value of the position keyword argument with the :end default value:
:start
Prepends a page to the notebook. This replaces the functions:
:end
Appends a page to the notebook. This replaces the functions:
otherwise
Insert a page into the notebook at the given position, which is an integer with the index starting from 0. This replaces the functions:
If the menu optinal argument is nil, that is the default value, and the tab argument is a gtk-label widget or nil, then the menu label will be a newly created label with the same text as tab. If the tab argument is not a gtk-label widget, the menu argument must be specified if the page-switch menu is to be used.
 

See also

2021-12-17