org.gnu.gtk

Class Notebook

public class Notebook extends Container

Deprecated: This class is part of the java-gnome 2.x family of libraries, which, due to their inefficiency and complexity, are no longer being maintained and have been abandoned by the java-gnome project. This class may in the future have an equivalent in java-gnome 4.0, try looking for org.gnome.gtk.Notebook. You should be aware that there is a considerably different API in the new library: the architecture is completely different and most notably internals are no longer exposed to public view.

A Notebook widget is a container whose children are pages that can be switched between using tab labels along one edge.

There are many configuration options for a Notebook. Among other things you can choose on which edge the tabs appear, whether, if there are too many tabs to fit th notebook should be made bigger or scrolling arrows added, and whether there will be a popup menu allowing the user to switch between pages.

Constructor Summary
Notebook()
Construct a new Notebook object with no pages.
Notebook(Handle handle)
Construct a new Notebook from a handle to a native resource.
Method Summary
voidaddListener(NotebookListener listener)
Register an object to receive event notification.
voidappendPage(Widget child, Widget tabLabel)
Append a page to the Notebook.
voidappendPage(Widget child, Widget tabLabel, Widget menuLabel)
Append a page to the Notebook.
intgetCurrentPage()
Returns the page number of the current page.
ClassgetEventListenerClass(String signal)
EventTypegetEventType(String signal)
static NotebookgetNotebook(Handle handle)
Internal static factory method to be used by Java-Gnome only.
intgetNumPages()
Return the number of pages currently on the notebook.
WidgetgetPage(int pageNum)
Returns the child Widget contained int he page number pageNum.
StringgetTabLabelText(Widget child)
Retrieves the text of the tab label for the page containing child.
static TypegetType()
Retrieve the runtime type used by the GLib library.
voidinsertPage(Widget child, Widget tabLabel, int position)
Insert a page into the Notebook at the given position.
voidinsertPage(Widget child, Widget tabLabel, Widget menuLabel, int position)
Insert a page into the Notebook at the given position.
voidnextPage()
Switches to the next page.
intpageNum(Widget child)
Finds the index of the page which contains the given child.
voidpopupDisable()
disables the popup menu.
voidpopupEnable()
Enables the popup menu.
voidprependPage(Widget child, Widget tabLabel)
Prepend a page to the Notebook.
voidprependPage(Widget child, Widget tabLabel, Widget menuLabel)
Prepend a page to the Notebook.
voidprevPage()
Switches to the previous page.
voidremoveListener(NotebookListener listener)
Unregister an object that was receiving notebook event notification.
voidremovePage(int pageNumber)
Removes a page fro the Notegook given its index in the notebook.
voidreorderChild(Widget child, int position)
Reorders the page containing child, so that it appears in position position.
voidsetCurrentPage(int pageNum)
sets the page at offset pageNum to the current page.
voidsetMenuLabel(Widget child, Widget menuLabel)
Changes the menu label for the page containing child.
voidsetMenuLabel(Widget child, String menuText)
Creates a new label and sets it as the menu label of child.
voidsetScrollable(boolean scrollable)
Sets whether the tab label area will have arrows for scrolling if there are too many tabs to fit in the area.
voidsetShowBorder(boolean showBorder)
Sets whether a bevel will be drawn around the notebook pages.
voidsetShowTabs(boolean showTabs)
sets whether to show the tabs for the notebook or not.
voidsetTabLabel(Widget child, Widget tabLabel)
Changes the tab label for child.
voidsetTabLabel(Widget child, String tabText)
Creates a new label and sets it as the label of the page containing child.
voidsetTabLabelPacking(Widget child, boolean expand, boolean fill, PackType packType)
Sets the packing parameters for the tab label of the page containing child.
voidsetTabPosition(PositionType pos)
Sets the edge at which the tabs for switching pages in the Notebook are drawn.

Constructor Detail

Notebook

public Notebook()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Construct a new Notebook object with no pages.

Notebook

public Notebook(Handle handle)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Construct a new Notebook from a handle to a native resource.

Method Detail

addListener

public void addListener(NotebookListener listener)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Register an object to receive event notification.

Parameters: listener The object that has implemented the NotebookListener interface that is to receive the notebook events.

appendPage

public void appendPage(Widget child, Widget tabLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Append a page to the Notebook.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null

appendPage

public void appendPage(Widget child, Widget tabLabel, Widget menuLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Append a page to the Notebook.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null menuLabel The widget to use as a label for the page-switching menu, if that is enabled. If null and tabLabel is a Label or null then the menu label will be a newly created label with the same text as the tabLabel.

getCurrentPage

public int getCurrentPage()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the page number of the current page. If the notebook has no pages, then -1 will be returned.

getEventListenerClass

public Class getEventListenerClass(String signal)

getEventType

public EventType getEventType(String signal)

getNotebook

public static Notebook getNotebook(Handle handle)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Internal static factory method to be used by Java-Gnome only.

getNumPages

public int getNumPages()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Return the number of pages currently on the notebook.

getPage

public Widget getPage(int pageNum)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Returns the child Widget contained int he page number pageNum.

getTabLabelText

public String getTabLabelText(Widget child)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Retrieves the text of the tab label for the page containing child.

Parameters: child a widget contained in a page of notebook

Returns: value: the text of the tab label, or NULL if the tab label widget is not a Label.

getType

public static Type getType()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Retrieve the runtime type used by the GLib library.

insertPage

public void insertPage(Widget child, Widget tabLabel, int position)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Insert a page into the Notebook at the given position.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null position The index (starting at 0) at which to insert the page.

insertPage

public void insertPage(Widget child, Widget tabLabel, Widget menuLabel, int position)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Insert a page into the Notebook at the given position.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null menuLabel The widget to use as a label for the page-switching menu, if that is enabled. If null and tabLabel is a Label or null then the menu label will be a newly created label with the same text as the tabLabel. position The index (starting at 0) at which to insert the page.

nextPage

public void nextPage()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Switches to the next page. Nothing happens if the current page is the last page.

pageNum

public int pageNum(Widget child)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Finds the index of the page which contains the given child.

Parameters: child The widget to locate.

Returns: The index of the page which contains the given child.

popupDisable

public void popupDisable()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

disables the popup menu.

popupEnable

public void popupEnable()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Enables the popup menu.

prependPage

public void prependPage(Widget child, Widget tabLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Prepend a page to the Notebook.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null

prependPage

public void prependPage(Widget child, Widget tabLabel, Widget menuLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Prepend a page to the Notebook.

Parameters: child The child widget to add to the newly created page. tabLabel The Widget to be used as the label for the page or null menuLabel The widget to use as a label for the page-switching menu, if that is enabled. If null and tabLabel is a Label or null then the menu label will be a newly created label with the same text as the tabLabel.

prevPage

public void prevPage()

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Switches to the previous page. Nothing happens if the current page is the first page.

removeListener

public void removeListener(NotebookListener listener)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Unregister an object that was receiving notebook event notification.

Parameters: listener The object that is to no longer receive notebook events.

removePage

public void removePage(int pageNumber)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Removes a page fro the Notegook given its index in the notebook.

Parameters: pageNumber The offset (starting with 0) for the page to remove.

reorderChild

public void reorderChild(Widget child, int position)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Reorders the page containing child, so that it appears in position position. If position is greater than or equal to the number of children in the list or negative, child will be moved to the end of the list.

Parameters: child The widget to move. position The index (starting with 0) to move the child.

setCurrentPage

public void setCurrentPage(int pageNum)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

sets the page at offset pageNum to the current page.

setMenuLabel

public void setMenuLabel(Widget child, Widget menuLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Changes the menu label for the page containing child.

setMenuLabel

public void setMenuLabel(Widget child, String menuText)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Creates a new label and sets it as the menu label of child.

setScrollable

public void setScrollable(boolean scrollable)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets whether the tab label area will have arrows for scrolling if there are too many tabs to fit in the area.

setShowBorder

public void setShowBorder(boolean showBorder)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets whether a bevel will be drawn around the notebook pages.

setShowTabs

public void setShowTabs(boolean showTabs)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

sets whether to show the tabs for the notebook or not.

setTabLabel

public void setTabLabel(Widget child, Widget tabLabel)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Changes the tab label for child.

setTabLabel

public void setTabLabel(Widget child, String tabText)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Creates a new label and sets it as the label of the page containing child.

setTabLabelPacking

public void setTabLabelPacking(Widget child, boolean expand, boolean fill, PackType packType)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets the packing parameters for the tab label of the page containing child.

See Also: Box

setTabPosition

public void setTabPosition(PositionType pos)

Deprecated: Superceeded by java-gnome 4.0; a method along these lines may well exist in the new bindings, but if it does it likely has a different name or signature due to the shift to an algorithmic mapping of the underlying native libraries.

Sets the edge at which the tabs for switching pages in the Notebook are drawn.