View Source wxNotebook (wx v2.4.2)
Functions for wxNotebook class
This class represents a notebook control, which manages multiple windows with associated tabs.
To use the class, create a wxNotebook
object and call
wxBookCtrlBase:addPage/4
or wxBookCtrlBase:insertPage/5
, passing a window to
be used as the page. Do not explicitly delete the window for a page that is
currently managed by wxNotebook
.
wxNotebookPage
is a typedef for wxWindow
.
Styles
This class supports the following styles:
Page backgrounds
On Windows, the default theme paints a background on the notebook's pages. If
you wish to suppress this theme, for aesthetic or performance reasons, there are
three ways of doing it. You can use wxNB_NOPAGETHEME
to disable themed drawing
for a particular notebook, you can call wxSystemOptions:setOption/2
to disable
it for the whole application, or you can disable it for individual pages by
using wxWindow:setBackgroundColour/2
.
To disable themed pages globally:
Set the value to 1 to enable it again. To give a single page a solid background that more or less fits in with the overall theme, use:
On platforms other than Windows, or if the application is not using Windows
themes, getThemeBackgroundColour/1
will return an uninitialised colour object,
and the above code will therefore work on all platforms.
See: ?wxBookCtrl, wxBookCtrlEvent
, wxImageList
,
Examples
This class is derived (and can use functions) from: wxBookCtrlBase
wxControl
wxWindow
wxEvtHandler
wxWidgets docs: wxNotebook
Events
Event types emitted from this class:
command_notebook_page_changed
,
command_notebook_page_changing
Summary
Functions
Sets the image list for the page control and takes ownership of the list.
Creates a notebook control.
Destroys the wxNotebook
object.
Returns the associated image list, may be NULL.
Returns the image index for the given page.
Returns the number of rows in the notebook control.
If running under Windows and themes are enabled for the application, this
function returns a suitable colour for painting the background of a notebook
page, and can be passed to wxWindow:setBackgroundColour/2
.
Constructs a notebook control.
Constructs a notebook control.
Sets the image list to use.
Sets the amount of space around each page's icon and label, in pixels.
Sets the image index for the given page.
Sets the width and height of the pages.
Types
-type wxNotebook() :: wx:wx_object().
Functions
-spec assignImageList(This, ImageList) -> ok when This :: wxNotebook(), ImageList :: wxImageList:wxImageList().
Sets the image list for the page control and takes ownership of the list.
See: wxImageList
, setImageList/2
-spec create(This, Parent, Id) -> boolean() when This :: wxNotebook(), Parent :: wxWindow:wxWindow(), Id :: integer().
-spec create(This, Parent, Id, [Option]) -> boolean() when This :: wxNotebook(), Parent :: wxWindow:wxWindow(), Id :: integer(), Option :: {pos, {X :: integer(), Y :: integer()}} | {size, {W :: integer(), H :: integer()}} | {style, integer()}.
Creates a notebook control.
See new/3
for a description of the parameters.
-spec destroy(This :: wxNotebook()) -> ok.
Destroys the wxNotebook
object.
-spec getImageList(This) -> wxImageList:wxImageList() when This :: wxNotebook().
Returns the associated image list, may be NULL.
See: wxImageList
, setImageList/2
-spec getPageImage(This, NPage) -> integer() when This :: wxNotebook(), NPage :: integer().
Returns the image index for the given page.
-spec getRowCount(This) -> integer() when This :: wxNotebook().
Returns the number of rows in the notebook control.
-spec getThemeBackgroundColour(This) -> wx:wx_colour4() when This :: wxNotebook().
If running under Windows and themes are enabled for the application, this
function returns a suitable colour for painting the background of a notebook
page, and can be passed to wxWindow:setBackgroundColour/2
.
Otherwise, an uninitialised colour will be returned.
-spec new() -> wxNotebook().
Constructs a notebook control.
-spec new(Parent, Id) -> wxNotebook() when Parent :: wxWindow:wxWindow(), Id :: integer().
-spec new(Parent, Id, [Option]) -> wxNotebook() when Parent :: wxWindow:wxWindow(), Id :: integer(), Option :: {pos, {X :: integer(), Y :: integer()}} | {size, {W :: integer(), H :: integer()}} | {style, integer()}.
Constructs a notebook control.
Note that sometimes you can reduce flicker by passing the wxCLIP_CHILDREN window style.
-spec setImageList(This, ImageList) -> ok when This :: wxNotebook(), ImageList :: wxImageList:wxImageList().
Sets the image list to use.
It does not take ownership of the image list, you must delete it yourself.
See: wxImageList
, assignImageList/2
-spec setPadding(This, Padding) -> ok when This :: wxNotebook(), Padding :: {W :: integer(), H :: integer()}.
Sets the amount of space around each page's icon and label, in pixels.
Note: The vertical padding cannot be changed in wxGTK.
-spec setPageImage(This, Page, Image) -> boolean() when This :: wxNotebook(), Page :: integer(), Image :: integer().
Sets the image index for the given page.
image
is an index into the image list which was set with setImageList/2
.
-spec setPageSize(This, Size) -> ok when This :: wxNotebook(), Size :: {W :: integer(), H :: integer()}.
Sets the width and height of the pages.
Note: This method is currently not implemented for wxGTK.