Package: gtk

Function gtk:notebook-add-page

Lambda List

gtk:notebook-add-page (notebook child tab &key pos 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'
pos -- 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

The 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 pos keyword argument with the :end default value:
:start
Prepends a page to the notebook. This replaces the functions:
  • gtk_notebook_prepend_page()
  • gtk_notebook_prepend_page_menu()
:end
Appends a page to the notebook. This replaces the functions:
  • gtk_notebook_append_page()
  • gtk_notebook_append_page_menu()
otherwise
Insert a page into the notebook at the given pos, which is an integer with the index starting from 0. This replaces the functions:
  • gtk_notebook_insert_page()
  • gtk_notebook_insert_page_menu()
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

2024-10-4