Gadget class. More...

#include <ilviews/gadgets/notebook.h>

Inheritance diagram for IlvNotebook:

Public Member Functions
	IlvNotebook (IlvDisplay display, const IlvRect &rect, IlvPosition tabsPosition=IlvTop, IlBoolean verticalLabels=IlFalse, IlBoolean flipLabels=IlFalse, IlvDim xMargin=5, IlvDim yMargin=2, IlUShort thickness=IlvDefaultGadgetThickness, IlvPalette palette=0)
	Constructor. More...

IlvNotebookPage *	addPage (const char label, IlvBitmap bitmap=0, IlBoolean transparent=IlTrue, const char *filename=0, IlUShort index=((IlUShort) -1))
	Adds a page to the notebook. More...

IlvNotebookPage *	addPage (IlvNotebookPage *page, IlUShort index=((IlUShort) -1))
	Adds a page to the notebook. More...

virtual IlBoolean	allowDragDrop () const
	Indicates whether drag-and-drop operations are allowed for the notebook. More...

void	allowDragDrop (IlBoolean allow)
	Specifies whether drag-and-drop operations should be allowed for the notebook. More...

virtual IlvGadgetItem *	applyToItems (IlvApplyGadgetItem, IlAny)
	Applies the specified function to all the items of the holder. More...

IlBoolean	areLabelsVertical () const
	Returns `IlTrue` if the tab labels are drawn vertically. More...

virtual IlBoolean	changeSelection (IlUShort index, IlBoolean redraw)
	Changes the selected page of the notebook. More...

virtual IlvGadgetItem *	createItem (const char , IlvGraphic =0, IlvBitmap =0, IlvBitmap =0, IlBoolean=IlTrue) const
	Returns a new gadget item. More...

virtual IlvView *	createView (IlvNotebookPage page, IlvAbstractView parent, const IlvRect &size)
	Is called by the pages to create their views. More...

virtual void	deleteView (IlvNotebookPage *page)
	Is called by the pages to delete their views. More...

void	ensureVisible (IlUShort index, IlBoolean redraw)
	Ensures that a given tab is visible. More...

void	flipLabels (IlBoolean value)
	Changes the display style of the notebook tabs labels. More...

IlUShort	getFirstVisibleTab () const
	Return the index of the first visible tab. More...

virtual void	getLabelOrientation (IlvOrientation &orientation, IlBoolean &flip) const
	Returns the orientation of tab labels. More...

virtual IlvPosition	getLabelPosition () const
	Returns the default position of the notebook tabs labels. More...

virtual IlvPalette *	getNormalTextPalette () const
	Returns the default palette used to draw an item. More...

virtual IlvPalette *	getOpaquePalette () const
	Returns the opaque palette used to draw opaque items. More...

IlvNotebookPage *	getPage (const char *name) const
	Returns a notebook page using its name. More...

virtual void	getPageArea (IlvRect &rect, const IlvTransformer *t=0) const
	Returns the bounding box of the page area. More...

IlvDim	getPageBottomMargin () const
	Returns the bottom margin between the notebook border and the page area. More...

IlvDim	getPageLeftMargin () const
	Returns the left margin between the notebook border and the page area. More...

IlvDim	getPageRightMargin () const
	Returns the right margin between the notebook border and the page area. More...

IlvNotebookPage **	getPages () const
	Returns the internal array of notebook pages. More...

IlUShort	getPagesCardinal () const
	Returns the number of pages of the notebook. More...

IlvDim	getPageTopMargin () const
	Returns the top margin between the notebook border and the page area. More...

IlvView *	getParent () const
	Returns the view where the notebook is displayed. More...

IlvNotebookPage *	getSelectedPage () const
	Returns a pointer to the `IlvNotebookPage` object corresponding to the selected page. More...

IlUShort	getSelectedPageIndex () const
	Returns the index of the selected page. More...

IlvPosition	getTabsPosition () const
	Returns the position of the tabs. More...

IlvDim	getXMargin () const
	Returns the x margin of the notebook. More...

IlvDim	getYMargin () const
	Returns the y margin of the notebook. More...

void	hide ()
	Hides the views of the Notebook pages. More...

void	hidePageView ()
	Hides the views of the Notebook pages.

IlBoolean	isPageViewVisible () const
	Retrieves the visibility of the page view. More...

virtual IlBoolean	isShowingLabel () const
	A Boolean indicating whether or not the notebook tabs labels are displayed. More...

virtual IlBoolean	isShowingPicture () const
	A Boolean indicating whether or not the notebook tabs pictures are displayed. More...

IlBoolean	mustFlipLabels () const
	Returns `IlTrue` if the labels of the notebook tabs are flipped. More...

virtual void	pageDeselected (IlvNotebookPage *page)
	Is called when a page is deselected. More...

virtual void	pageResized (IlvNotebookPage *page)
	Is called when a page is resized. More...

virtual void	pageSelected (IlvNotebookPage *page)
	Is called when a page is selected. More...

virtual IlShort	pointToTabIndex (const IlvPoint &point, const IlvTransformer *t) const
	Returns the index of the tab located at the specified position. More...

virtual void	recomputeAllItems ()
	Recomputes the size of all the items managed by the holder. More...

void	removePage (IlUShort index, IlBoolean destroy=IlTrue)
	Removes a page of the notebook. More...

void	setFirstVisibleTab (IlUShort index)
	Changes the first visible tab. More...

void	setLabelOrientation (IlvOrientation orientation, IlBoolean flip=IlFalse, IlBoolean redraw=IlTrue)
	Set the orientation of tab labels. More...

void	setLabelPosition (IlvPosition position, IlBoolean redraw=IlTrue)
	Sets the default position of the matrix items labels. More...

void	setLabelsVertical (IlBoolean value)
	Changes the orientation of the labels. More...

void	setPageBottomMargin (IlvDim margin)
	Changes the bottom margin between the notebook border and the page area. More...

void	setPageLeftMargin (IlvDim margin)
	Changes the left margin between the notebook border and the page area. More...

void	setPageRightMargin (IlvDim margin)
	Changes the right margin between the notebook border and the page area. More...

void	setPageTopMargin (IlvDim margin)
	Changes the top margin between the notebook border and the page area. More...

void	setSelectedPageIndex (IlUShort index)
	Changes the selected page index. More...

void	setTabsPosition (IlvPosition position)
	Changes the position of the tabs. More...

virtual void	setVisible (IlBoolean)
	Sets the visibility of both this IlvNotebook (as IlvGraphic) and the page view.

void	setXMargin (IlvDim x)
	Changes the x margin of the notebook. More...

void	setYMargin (IlvDim y)
	Changes the y margin of the notebook. More...

void	show ()
	Shows the views of the Notebook pages. More...

void	showLabel (IlBoolean value=IlTrue, IlBoolean redraw=IlTrue)
	Shows or hides the notebook tabs labels. More...

void	showPageView ()
	Shows the views of the Notebook pages.

void	showPicture (IlBoolean value=IlTrue, IlBoolean redraw=IlTrue)
	Shows or hides the pictures associated with the notebook tabs. More...

Public Member Functions inherited from IlvGadgetItemHolder
virtual void	drawGadgetItem (const IlvGadgetItem item, IlvPort port, const IlvRect &rect, const IlvTransformer t=0, const IlvRegion clip=0) const
	Draws a specific gadget item. More...

IlvGadgetItem *	getCallbackItem () const
	Returns the item that triggered a callback. More...

IlvGadgetItem *	getDragDropTarget () const
	Returns the target item of a drag-and-drop operation. More...

IlvGraphic *	getDraggedImage () const
	Returns the graphic object used to draw the ghost image during a drag-and-drop operation. More...

IlvGadgetItem *	getDraggedItem () const
	Returns the item that is being dragged during a drag-and-drop operation. More...

IlvGadgetItem *	getEditedItem () const
	Returns the item that is being edited. More...

virtual IlvPalette *	getHighlightTextPalette () const
	Returns the highlight palette used to draw the label of highlighted items. More...

virtual IlvGadgetItem *	getItemByName (const char *name) const
	Returns the item whose name is specified. More...

IlvGadgetItem *	getToolTipItem () const
	Returns the item that is displaying a tooltip. More...

virtual void	initReDrawItems ()
	Begins a redraw session. More...

virtual void	reDrawItems ()
	Ends a redraw session. More...

void	setDragDropTarget (IlvGadgetItem *item)
	Sets the target item of a drag-and-drop operation. More...

void	setDraggedImage (IlvGraphic *graphic)
	Sets the graphic object used to draw the ghost image during a drag-and-drop operation. More...

void	setDraggedItem (IlvGadgetItem *item)
	Sets the dragged item. More...

Static Public Member Functions
static IlSymbol *	PageDeselectedCallbackType ()
	Returns the callback type for the Page Deselected callback. More...

static IlSymbol *	PageResizedCallbackType ()
	Returns the callback type for the Page Resized callback. More...

static IlSymbol *	PageSelectedCallbackType ()
	Returns the callback type for the Page Selected callback. More...

Static Public Member Functions inherited from IlvGadgetItemHolder
static IlSymbol *	AbortDragItemCallbackType ()
	Returns the callback type of the Abort Drag callback. More...

static IlSymbol *	AbortEditItemCallbackType ()
	Returns the callback type of the Abort Edit callback. More...

static IlSymbol *	ActivateCallbackType ()
	Returns the callback type of the Activate callback. More...

static IlSymbol *	DragItemCallbackType ()
	Returns the callback type of the Drag Item callback. More...

static IlSymbol *	EndDragItemCallbackType ()
	Returns the callback type of the End Drag callback. More...

static IlSymbol *	EndEditItemCallbackType ()
	Returns the callback type of the End Edit callback. More...

static IlSymbol *	StartDragItemCallbackType ()
	Returns the callback type of the Start Drag callback. More...

static IlSymbol *	StartEditItemCallbackType ()
	Returns the callback type of the Start Edit callback. More...

Friends
class	IlvDefaultNotebookLFHandler

class	IlvNotebookPage

Additional Inherited Members
Protected Member Functions inherited from IlvGadgetItemHolder
virtual void	abortDragItem ()
	Is called when a drag-and-drop operation is aborted. More...

virtual void	abortEdit (IlvGadgetItem *item)
	Is called when the editing of the specified item is aborted. More...

virtual void	drawDraggedImage (const IlvPoint &point, const IlvTransformer *t)
	Is called to draw the ghost image during a drag-and-drop operation. More...

virtual void	endDragItem (const IlvPoint &point)
	Is called when a drag-and-drop operation is finished. More...

virtual void	endEdit (IlvGadgetItem *item)
	Is called after an item has been edited. More...

virtual void	itemActivated (IlvGadgetItem *item)
	Is called when an item is activated. More...

virtual void	itemDeSelected (IlvGadgetItem *item)
	Is called when an item is deselected. More...

virtual void	itemDragged (const IlvPoint &point)
	Is called each time the user moves the mouse during a drag-and-drop operation. More...

virtual void	itemHighlighted (IlvGadgetItem *item)
	Is called when an item is highlighted or unhighlighted. More...

virtual void	itemSelected (IlvGadgetItem *item)
	Is called when an item is selected. More...

virtual void	startDragItem (IlvGadgetItem *item)
	Is called when a drag-and-drop operation begins. More...

virtual void	startEdit (IlvGadgetItem *item)
	Is called when an item is edited. More...

Detailed Description

Gadget class.

Library: ilvadvgdt

IlvNotebook is a predefined gadget class that simulates a real notebook. It allows the user to select the pages of the notebook by using the pointing device.

- IlvNotebook and IlvNotebookPage -

You can customize the notebook to meet your specific application requirements:

Tabs can be displayed on any side of the notebook.
Tabs can contain a simple label or a bitmap (or both).
Tab labels can be displayed vertically or horizontally.

Each page of the notebook is implemented by the class IlvNotebookPage. The default implementation of this class is to create an IlvGadgetContainer that displays the contents of the page.

See also: IlvNotebookPage.

Accessors\nAccessors provide a scriptable and uniform way to inspect and modify an object by using its base class methods <tt>IlvValueInterface::queryValue()</tt>, <tt>IlvValueInterface::queryValues()</tt>, <tt>IlvValueInterface::changeValue()</tt>, <tt>IlvValueInterface::changeValues()</tt>.\n\n\nThis class inherits the accessors of its superclass \c IlvGadget and adds the following ones:

Data accessors

Name	Type	Equivalent methods
`count`	UInt	`getPagesCardinal()`
`selectedPage`	UInt	`getSelectedPageIndex()`, `changeSelection()`
`tabsPosition`	Direction	`getTabsPosition()`, `setTabsPosition()`
`verticalLabels`	Boolean	`areLabelsVertical()`, `setLabelsVertical()`
`flipLabels`	Boolean	`mustFlipLabels()`, `flipLabels()`
`flipLabel`	Boolean	`getLabelOrientation()`, `flipLabels()`
`showLabel`	Boolean	`isShowingLabel()`, `showLabel()`
`showPicture`	Boolean	`isShowingPicture()`, `showPicture()`
`labelPosition`	Direction	`getLabelPosition()`, `setLabelPosition()`
`labelOrientation`	Direction	`getLabelOrientation()`, `setLabelOrientation()`
`dragdrop`	Boolean	`allowDragDrop() const`, `allowDragDrop(IlBoolean)`
`tabXMargin`	UInt	`getXMargin()`, `setXMargin()`
`tabYMargin`	UInt	`getYMargin()`, `setYMargin()`
`topPageMargin`	UInt	`getPageTopMargin()`, `setPageTopMargin()`
`bottomPageMargin`	UInt	`getPageBottomMargin()`, `setPageBottomMargin()`
`leftPageMargin`	UInt	`getPageLeftMargin()`, `setPageLeftMargin()`
`rightPageMargin`	UInt	`getPageRightMargin()`, `setPageRightMargin()`
`firstVisible`	UInt	`getFirstVisibleTab()`, `setFirstVisibleTab()`
`pageArea`	Object	`getPageArea()`
`parent`	Object	`getParent()`

Method accessors

Name	Return type	Equivalent methods
`ensureVisible(UInt index)`	Void	`ensureVisible()`
`getPage(UInt index)`	Object	`getPages()[index]`
`getPageByName(String name)`	Object	`getPage(const char* name) const`

Styling\nThis class supports the following CSS properties:

Graphic property	CSS property	Type
Background color	`background-color`	Color
Text color	`color`	Color

Constructor & Destructor Documentation

◆ IlvNotebook()

IlvNotebook::IlvNotebook	(	IlvDisplay *	display,
		const IlvRect &	rect,
		IlvPosition	tabsPosition = `IlvTop`,
		IlBoolean	verticalLabels = `IlFalse`,
		IlBoolean	flipLabels = `IlFalse`,
		IlvDim	xMargin = `5`,
		IlvDim	yMargin = `2`,
		IlUShort	thickness = `IlvDefaultGadgetThickness`,
		IlvPalette *	palette = `0`
	)

Constructor.

Initializes a new instance of the IlvNotebook class.

Parameters

display	The display connection.
rect	The size and position of the notebook.
tabsPosition	See the `getTabsPosition()` method for the definition of this parameter.
verticalLabels	A Boolean specifying whether to draw the labels of the tabs vertically or not.
flipLabels	A Boolean specifying whether to draw the labels of the tabs from the top to the bottom, or from the bottom to the top. This parameter is only used in case of vertical labels, that is, if verticalLabels is `IlTrue`.
xMargin	The margin between the tab and its label. See `getXMargin()` for more informations.
yMargin	The margin between the tab and its label. See `getYMargin()` for more informations.
thickness	The gadget thickness.
palette	The palette used by the notebook.

Member Function Documentation

◆ addPage() [1/2]

IlvNotebookPage* IlvNotebook::addPage	(	const char *	label,
		IlvBitmap *	bitmap = `0`,
		IlBoolean	transparent = `IlTrue`,
		const char *	filename = `0`,
		IlUShort	index = `((IlUShort) -1)`
	)

Adds a page to the notebook.

Creates a new IlvNotebookPage and adds it to the notebook at the position index.

Parameters

label	The tab label.
bitmap	The tab bitmap
transparent	Obsolete.
filename	The name of the `.ilv` file to load onto the page.
index	The position where to add the page.

See also: addPage(IlvNotebookPage*, IlUShort).

◆ addPage() [2/2]

IlvNotebookPage* IlvNotebook::addPage	(	IlvNotebookPage *	page,
		IlUShort	index = `((IlUShort) -1)`
	)

Adds a page to the notebook.

Parameters

page	The page that will be added.
index	The index where page will be added.

Returns: The parameter page.

See also: removePage(), addPage(const char*, IlvBitmap*, IlBoolean, const char*, IlUShort).

◆ allowDragDrop() [1/2]

virtual IlBoolean IlvNotebook::allowDragDrop ( ) const

virtual

Indicates whether drag-and-drop operations are allowed for the notebook.

Returns: IlTrue if drag-and-drop operations are allowed and IlFalse otherwise.

See also: IlvGadgetItemHolder::startDragItem(), IlvGadgetItemHolder::allowDragDrop(IlBoolean).

Reimplemented from IlvGadgetItemHolder.

◆ allowDragDrop() [2/2]

void IlvNotebook::allowDragDrop ( IlBoolean allow )

Specifies whether drag-and-drop operations should be allowed for the notebook.

Parameters

allow A Boolean value specifying whether drag-and-drop operations should be allowed (IlTrue).

See also: IlvGadgetItemHolder::startDragItem(), IlvGadgetItemHolder::allowDragDrop().

◆ applyToItems()

virtual IlvGadgetItem* IlvNotebook::applyToItems	(	IlvApplyGadgetItem	func,
		IlAny	arg
	)

virtual

Applies the specified function to all the items of the holder.

Parameters

func	The function to be applied.
arg	The argument that will be passed to the function func.

Returns: The item that stopped the operation.

See also: IlvApplyGadgetItem, recomputeAllItems(), getItemByName().

Reimplemented from IlvGadgetItemHolder.

◆ areLabelsVertical()

IlBoolean IlvNotebook::areLabelsVertical ( ) const

Returns IlTrue if the tab labels are drawn vertically.

Each tab of the notebook can contain a label, which can be drawn horizontally or vertically.

Returns: IlTrue if the tab labels are drawn vertically.

See also: setLabelsVertical(), getLabelPosition(), getTabsPosition().

◆ changeSelection()

virtual IlBoolean IlvNotebook::changeSelection	(	IlUShort	index,
		IlBoolean	redraw
	)

virtual

Changes the selected page of the notebook.

The page must be sensitive (see the IlvNotebookPage::isSensitive() method). The method pageDeselected() is called on the previous selected page, and the method pageSelected() on the new selected page.

Returns: IlTrue if the page has been successfully selected.

Parameters

index	The index of the page (or tab).
redraw	Specifies whether the gadget should be redrawn.

See also: setFirstVisibleTab().

◆ createItem()

virtual IlvGadgetItem* IlvNotebook::createItem	(	const char *	label,
		IlvGraphic *	graphic = `0`,
		IlvBitmap *	bitmap = `0`,
		IlvBitmap *	selbitmap = `0`,
		IlBoolean	copy = `IlTrue`
	)		const

virtual

Returns a new gadget item.

You can override this member function in a subclass to create your own items.

Parameters

label	The item label.
graphic	The `IlvGraphic` object representing the picture associated with the item.
bitmap	The `IlvBitmap` object representing the picture associated with the item.
selbitmap	The `IlvBitmap` object representing the picture of the item when it is selected.
copy	Specifies whether a label should be copied. If the value is `IlFalse`, then you must allocate some memory for the label because in any case the label characters are deleted from the memory by the IlvGadgetItem.

Note: If both the second and third parameters are not 0, only the second parameter is used.

Returns: The created gadget item.

Reimplemented from IlvGadgetItemHolder.

◆ createView()

virtual IlvView* IlvNotebook::createView	(	IlvNotebookPage *	page,
		IlvAbstractView *	parent,
		const IlvRect &	size
	)

virtual

Is called by the pages to create their views.

The default implementation is to call the IlvNotebookPage::createView() method. You can overload this method to create another kind of view. Overloading this method means creating a view. The parent of this new view must be parent and the size of the view must be size. The view must be created invisible. If you overload this method, the IlvNotebookPage::createView() method is no longer called.

Parameters

page	The page that requested the view creation.
parent	The parent of the view to be created.
size	The size of the view to be created.

Returns: The created view of the notebook page.

See also: deleteView(), IlvNotebookPage::createView().

◆ deleteView()

virtual void IlvNotebook::deleteView ( IlvNotebookPage * page )

virtual

Is called by the pages to delete their views.

The default implementation is to call the IlvNotebookPage::deleteView() method. If you overload this method, the IlvNotebookPage::deleteView() method is no longer called.

Parameters

page	The page that requested the view deletion.

See also: createView(), IlvNotebookPage::deleteView().

◆ ensureVisible()

void IlvNotebook::ensureVisible	(	IlUShort	index,
		IlBoolean	redraw
	)

Ensures that a given tab is visible.

Ensures that the tab with the index index becomes visible. This does not change the selected tab.

Parameters

index	The tab index.
redraw	Specifies whether the gadget should be redrawn.

See also: changeSelection(), getFirstVisibleTab().

◆ flipLabels()

void IlvNotebook::flipLabels ( IlBoolean value )

Changes the display style of the notebook tabs labels.

See the method mustFlipLabels().

Parameters

value Specifies whether or not that labels of the notebook tabs should be flipped.

See also: mustFlipLabels(), setLabelsVertical().

◆ getFirstVisibleTab()

IlUShort IlvNotebook::getFirstVisibleTab ( ) const

Return the index of the first visible tab.

Returns: The index (starting at 0) of the first visible tab. If this value is not 0, some tabs are not visible and the scrolling arrows are visible.

See also: setFirstVisibleTab(), changeSelection(), ensureVisible().

◆ getLabelOrientation()

virtual void IlvNotebook::getLabelOrientation	(	IlvOrientation &	orientation,
		IlBoolean &	flip
	)		const

virtual

Returns the orientation of tab labels.

The orientation may be IlvHorizontal or IlvVertical.

Parameters

orientation	Return value for the label orientation.
flip	Return value indicating if labels are drawn top to bottom or bottom to top. This value is only meaningful if the orientation is `IlvVertical`.

See also: areLabelsVertical(), mustFlipLabels()

Reimplemented from IlvGadgetItemHolder.

◆ getLabelPosition()

virtual IlvPosition IlvNotebook::getLabelPosition ( ) const

virtual

Returns the default position of the notebook tabs labels.

Returns: The default position of the labels associated with the notebook tabs relative to their picture.

See also: setLabelPosition().

Reimplemented from IlvGadgetItemHolder.

◆ getNormalTextPalette()

virtual IlvPalette* IlvNotebook::getNormalTextPalette ( ) const

virtual

Returns the default palette used to draw an item.

Returns: The default palette used to draw an item.

Implements IlvGadgetItemHolder.

◆ getOpaquePalette()

virtual IlvPalette* IlvNotebook::getOpaquePalette ( ) const

virtual

Returns the opaque palette used to draw opaque items.

Returns: The opaque palette used to draw opaque items.

Reimplemented from IlvGadgetItemHolder.

◆ getPage()

IlvNotebookPage* IlvNotebook::getPage ( const char * name ) const

Returns a notebook page using its name.

Parameters

name	The name of the page.

Returns: The specified notebook page or 0 if the specified page is not in the notebook.

See also: IlvNotebookPage::getName().

◆ getPageArea()

virtual void IlvNotebook::getPageArea	(	IlvRect &	rect,
		const IlvTransformer *	t = `0`
	)		const

virtual

Returns the bounding box of the page area.

Puts in rect the rectangle of the page area with the page margin having already been taken into account.

Parameters

rect	The returned bounding box of the page area.
t	The transformer applied to the notebook.

See also: getPageRightMargin(), getPageTopMargin(), getPageLeftMargin(), getPageBottomMargin().

◆ getPageBottomMargin()

IlvDim IlvNotebook::getPageBottomMargin ( ) const

Returns the bottom margin between the notebook border and the page area.

Returns: The bottom margin between the notebook border and the page area.

See also: setPageBottomMargin(), getPageTopMargin(), getPageLeftMargin(), getPageRightMargin(), getPageArea().

◆ getPageLeftMargin()

IlvDim IlvNotebook::getPageLeftMargin ( ) const

Returns the left margin between the notebook border and the page area.

Returns: The left margin between the notebook border and the page area.

See also: setPageLeftMargin(), getPageBottomMargin(), getPageTopMargin(), getPageRightMargin(), getPageArea().

◆ getPageRightMargin()

IlvDim IlvNotebook::getPageRightMargin ( ) const

Returns the right margin between the notebook border and the page area.

Returns: The right margin between the notebook border and the page area.

See also: setPageRightMargin(), getPageBottomMargin(), getPageLeftMargin(), getPageTopMargin(), getPageArea().

◆ getPages()

IlvNotebookPage** IlvNotebook::getPages ( ) const

Returns the internal array of notebook pages.

To get the first page of the notebook, you can use notebook->getPages()[0].

Returns: The internal array of notebook pages.

See also: getPage().

◆ getPagesCardinal()

IlUShort IlvNotebook::getPagesCardinal ( ) const

Returns the number of pages of the notebook.

Returns: the number of pages of the notebook.

See also: addPage().

◆ getPageTopMargin()

IlvDim IlvNotebook::getPageTopMargin ( ) const

Returns the top margin between the notebook border and the page area.

Returns: The top margin between the notebook border and the page area.

See also: setPageTopMargin(), getPageBottomMargin(), getPageLeftMargin(), getPageRightMargin(), getPageArea().

◆ getParent()

IlvView* IlvNotebook::getParent ( ) const

Returns the view where the notebook is displayed.

Returns: The view where the notebook is displayed, or 0 if the notebook has not been added to any holder.

◆ getSelectedPage()

IlvNotebookPage* IlvNotebook::getSelectedPage ( ) const

Returns a pointer to the IlvNotebookPage object corresponding to the selected page.

Returns: A pointer to the IlvNotebookPage object corresponding to the selected page.

See also: getSelectedPageIndex().

◆ getSelectedPageIndex()

IlUShort IlvNotebook::getSelectedPageIndex ( ) const

Returns the index of the selected page.

Returns: The index of the selected page.

See also: getSelectedPage().

◆ getTabsPosition()

IlvPosition IlvNotebook::getTabsPosition ( ) const

Returns the position of the tabs.

Tabs can be displayed on any side of the notebook (IlvTop, IlvRight, IlvLeft, IlvBottom).

Returns: The position of the tabs.

See also: setTabsPosition(), getLabelPosition(), areLabelsVertical().

◆ getXMargin()

IlvDim IlvNotebook::getXMargin ( ) const

Returns the x margin of the notebook.

This margin is the horizontal space between the border of the tab and the tab label. This margin becomes a vertical space when labels are drawn vertically.

Returns: The x margin of the notebook.

See also: setXMargin(), getYMargin().

◆ getYMargin()

IlvDim IlvNotebook::getYMargin ( ) const

Returns the y margin of the notebook.

This margin is the vertical space between the border of the tab and the tab label. This margin becomes a horizontal space when labels are drawn horizontally.

Returns: The y margin of the notebook.

See also: setYMargin(), getXMargin().

◆ hide()

void IlvNotebook::hide ( )

Hides the views of the Notebook pages.

Deprecated, replaced by 'hidePageView()'.

◆ isPageViewVisible()

IlBoolean IlvNotebook::isPageViewVisible ( ) const

Retrieves the visibility of the page view.

Returns: A value indicating whether the page view is visible or not.

◆ isShowingLabel()

virtual IlBoolean IlvNotebook::isShowingLabel ( ) const

virtual

A Boolean indicating whether or not the notebook tabs labels are displayed.

Returns: IlTrue if the labels associated with the tabs of the notebook are displayed.

See also: showLabel().

Reimplemented from IlvGadgetItemHolder.

◆ isShowingPicture()

virtual IlBoolean IlvNotebook::isShowingPicture ( ) const

virtual

A Boolean indicating whether or not the notebook tabs pictures are displayed.

Returns: IlTrue if the pictures associated with the notebook tabs are displayed.

See also: showPicture().

Reimplemented from IlvGadgetItemHolder.

◆ mustFlipLabels()

IlBoolean IlvNotebook::mustFlipLabels ( ) const

Returns IlTrue if the labels of the notebook tabs are flipped.

Returns: IlTrue if the labels of the notebook tabs are flipped, IlFalse otherwise. When the labels of the tabs are displayed vertically; see the method setLabelsVertical(), the label can be written from top to bottom, or from bottom to top. When the label is displayed from bottom to top, the label is said to be flipped.

See also: flipLabels(), setLabelsVertical().

◆ pageDeselected()

virtual void IlvNotebook::pageDeselected ( IlvNotebookPage * page )

virtual

Is called when a page is deselected.

Is called by the changeSelection() method. The default implementation is to call the IlvNotebookPage::deSelect() method and the Page Deselected callback.

Parameters

page	The notebook page.

See also: pageSelected(), PageDeselectedCallbackType.

◆ PageDeselectedCallbackType()

static IlSymbol* IlvNotebook::PageDeselectedCallbackType ( )

static

Returns the callback type for the Page Deselected callback.

The Page Deselected callback is called when a page has bee deselected, that is, a new page has been selected.

Returns: The callback type for the Page Deselected callback.

See also: pageDeselected(), changeSelection().

◆ pageResized()

virtual void IlvNotebook::pageResized ( IlvNotebookPage * page )

virtual

Is called when a page is resized.

The default implementation is to call the IlvNotebookPage::resized() method and the Page Resized callback.

Parameters

page	The notebook page.

See also: PageResizedCallbackType.

◆ PageResizedCallbackType()

static IlSymbol* IlvNotebook::PageResizedCallbackType ( )

static

Returns the callback type for the Page Resized callback.

The Page Resized callback is called when the page area of the notebook is resized. This occurs when the notebook itself is resized, or when the the tabs position changes for example.

Returns: The callback type for the Page Resized callback.

See also: pageResized().

◆ pageSelected()

virtual void IlvNotebook::pageSelected ( IlvNotebookPage * page )

virtual

Is called when a page is selected.

Is called by the() changeSelection method. The default implementation is to call the IlvNotebookPage::select() method and the Page Selected callback.

Parameters

page	The notebook page.

See also: pageDeselected(), PageSelectedCallbackType.

◆ PageSelectedCallbackType()

static IlSymbol* IlvNotebook::PageSelectedCallbackType ( )

static

Returns the callback type for the Page Selected callback.

The Page Selected callback is called when a new page has been selected.

Returns: The callback type for the Page Selected callback.

See also: pageSelected(), changeSelection().

◆ pointToTabIndex()

virtual IlShort IlvNotebook::pointToTabIndex	(	const IlvPoint &	point,
		const IlvTransformer *	t
	)		const

virtual

Returns the index of the tab located at the specified position.

The method calls getTabRect() for all the visible pages, and returns the one that contains point.

Parameters

point	The position in view coordinates.
t	The transformer applied to the notebook list.

Returns: The index of the tab located at the position specified by point when this notebook is displayed with the transformer t. If no tab contains point, the method returns -1.

See also: getTabRect().

◆ recomputeAllItems()

virtual void IlvNotebook::recomputeAllItems ( )

virtual

Recomputes the size of all the items managed by the holder.

Calls the IlvGadgetItem::recomputeSize() member function for all the items managed by this holder.

See also: IlvGadgetItem::recomputeSize(), applyToItems().

Reimplemented from IlvGadgetItemHolder.

◆ removePage()

void IlvNotebook::removePage	(	IlUShort	index,
		IlBoolean	destroy = `IlTrue`
	)

Removes a page of the notebook.

A notebook must have at least one page to work properly. You can remove all the pages to change them, but you must then add at least one page.

Parameters

index	The index of the page to remove.
destroy	A Boolean specifying whether to destroy the page that will be removed.

See also: addPage().

◆ setFirstVisibleTab()

void IlvNotebook::setFirstVisibleTab ( IlUShort index )

Changes the first visible tab.

This only scrolls the tabs and does not change the selected page.

Parameters

index The new first visible tab index.

See also: getFirstVisibleTab(), changeSelection(), ensureVisible().

◆ setLabelOrientation()

void IlvNotebook::setLabelOrientation	(	IlvOrientation	orientation,
		IlBoolean	flip = `IlFalse`,
		IlBoolean	redraw = `IlTrue`
	)

Set the orientation of tab labels.

Parameters

orientation	Indicates the new orientation of labels. May be `IlvHorizontal` or `IlvVertical`.
flip	Specifies whether tab labels should be flipped.
redraw	If set to `IlTrue`, the notebook is redrawn.

See also: setLabelsVertical(), flipLabels().

◆ setLabelPosition()

void IlvNotebook::setLabelPosition	(	IlvPosition	position,
		IlBoolean	redraw = `IlTrue`
	)

Sets the default position of the matrix items labels.

This setting is used to compute the geometry of each notebook tab For more information, see the member function IlvGadgetItem::setLabelPosition().

Parameters

position	The new position of the labels relative to pictures of notebook tabs.
redraw	Specifies whether the gadget should be redrawn.

See also: getLabelPosition(), IlvGadgetItem::setLabelPosition().

◆ setLabelsVertical()

void IlvNotebook::setLabelsVertical ( IlBoolean value )

Changes the orientation of the labels.

Each tab of the notebook can contain a label, which can be drawn horizontally or vertically.

Parameters

value Specifies whether or not the labels of the notebook tabs should be drawn vertically.

See also: areLabelsVertical(), setLabelPosition(), setTabsPosition().

◆ setPageBottomMargin()

void IlvNotebook::setPageBottomMargin ( IlvDim margin )

Changes the bottom margin between the notebook border and the page area.

Parameters

margin The new margin.

See also: getPageBottomMargin(), setPageTopMargin(), setPageLeftMargin(), setPageRightMargin().

◆ setPageLeftMargin()

void IlvNotebook::setPageLeftMargin ( IlvDim margin )

Changes the left margin between the notebook border and the page area.

Parameters

margin The new margin.

See also: getPageLeftMargin(), setPageBottomMargin(), setPageTopMargin(), setPageRightMargin().

◆ setPageRightMargin()

void IlvNotebook::setPageRightMargin ( IlvDim margin )

Changes the right margin between the notebook border and the page area.

Parameters

margin The new margin.

See also: getPageRightMargin(), setPageBottomMargin(), setPageLeftMargin(), setPageTopMargin().

◆ setPageTopMargin()

void IlvNotebook::setPageTopMargin ( IlvDim margin )

Changes the top margin between the notebook border and the page area.

Parameters

margin The new margin.

See also: getPageTopMargin(), setPageBottomMargin(), setPageLeftMargin(), setPageRightMargin().

◆ setSelectedPageIndex()

void IlvNotebook::setSelectedPageIndex ( IlUShort index )

Changes the selected page index.

Unlike the method changeSelection(), this method does not call any other methods.

Parameters

index The new selected page index.

See also: changeSelection().

◆ setTabsPosition()

void IlvNotebook::setTabsPosition ( IlvPosition position )

Changes the position of the tabs.

Tabs can be displayed on any side of the notebook (IlvTop, IlvRight, IlvLeft, IlvBottom).

Parameters

position The new tabs position.

See also: getTabsPosition(), setLabelPosition(), setLabelsVertical().

◆ setXMargin()

void IlvNotebook::setXMargin ( IlvDim x )

Changes the x margin of the notebook.

See the method getXMargin().

Parameters

x	The new x margin of the notebook.

See also: getXMargin(), setYMargin().

◆ setYMargin()

void IlvNotebook::setYMargin ( IlvDim y )

Changes the y margin of the notebook.

See the method getYMargin().

Parameters

y	The new y margin of the notebook.

See also: getYMargin(), setXMargin().

◆ show()

void IlvNotebook::show ( )

Shows the views of the Notebook pages.

Deprecated, replaced by 'showPageView()'.

◆ showLabel()

void IlvNotebook::showLabel	(	IlBoolean	value = `IlTrue`,
		IlBoolean	redraw = `IlTrue`
	)

Shows or hides the notebook tabs labels.

Parameters

value	A Boolean specifying whether the notebook should show the the labels associated with its tabs.
redraw	A Boolean specifying whether the gadget should be redrawn.

See also: isShowingLabel().

◆ showPicture()

void IlvNotebook::showPicture	(	IlBoolean	value = `IlTrue`,
		IlBoolean	redraw = `IlTrue`
	)

Shows or hides the pictures associated with the notebook tabs.

Parameters

value	A Boolean specifying whether the notebook should show the the pictures associated with its tabs.
redraw	A Boolean specifying whether the gadget should be redrawn.

See also: isShowingPicture().

Public Member Functions

Static Public Member Functions

Friends

Additional Inherited Members

Detailed Description

Data accessors

Method accessors

Styling\nThis class supports the following CSS properties:

Constructor & Destructor Documentation

◆ IlvNotebook()

Member Function Documentation

◆ addPage() [1/2]

◆ addPage() [2/2]

◆ allowDragDrop() [1/2]

◆ allowDragDrop() [2/2]

◆ applyToItems()

◆ areLabelsVertical()

◆ changeSelection()

◆ createItem()

◆ createView()

◆ deleteView()

◆ ensureVisible()

◆ flipLabels()

◆ getFirstVisibleTab()

◆ getLabelOrientation()

◆ getLabelPosition()

◆ getNormalTextPalette()

◆ getOpaquePalette()

◆ getPage()

◆ getPageArea()

◆ getPageBottomMargin()

◆ getPageLeftMargin()

◆ getPageRightMargin()

◆ getPages()

◆ getPagesCardinal()

◆ getPageTopMargin()

◆ getParent()

◆ getSelectedPage()

◆ getSelectedPageIndex()

◆ getTabsPosition()

◆ getXMargin()

◆ getYMargin()

◆ hide()

◆ isPageViewVisible()

◆ isShowingLabel()

◆ isShowingPicture()

◆ mustFlipLabels()

◆ pageDeselected()

◆ PageDeselectedCallbackType()

◆ pageResized()

◆ PageResizedCallbackType()

◆ pageSelected()

◆ PageSelectedCallbackType()

◆ pointToTabIndex()

◆ recomputeAllItems()

◆ removePage()

◆ setFirstVisibleTab()

◆ setLabelOrientation()

◆ setLabelPosition()

◆ setLabelsVertical()

◆ setPageBottomMargin()

◆ setPageLeftMargin()

◆ setPageRightMargin()

◆ setPageTopMargin()

◆ setSelectedPageIndex()

◆ setTabsPosition()

◆ setXMargin()

◆ setYMargin()

◆ show()

◆ showLabel()

◆ showPicture()