.TH "KJanusWidget" 3 "28 Jan 2004" "kdeui Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
KJanusWidget \- Provides a number of ready to use layouts (faces). Easy to use widget with many layouts.  

.PP
.SH SYNOPSIS
.br
.PP
\fC#include <kjanuswidget.h>\fP
.PP
Inherits \fBQWidget\fP.
.PP
.SS "Public Types"

.in +1c
.ti -1c
.RI "enum \fBFace\fP { \fBTreeList\fP =  0, \fBTabbed\fP, \fBPlain\fP, \fBSwallow\fP, \fBIconList\fP }"
.br
.in -1c
.SS "Public Slots"

.in +1c
.ti -1c
.RI "virtual void \fBsetFocus\fP ()"
.br
.RI "\fIGive the keyboard input focus to the widget. \fP"
.in -1c
.SS "Signals"

.in +1c
.ti -1c
.RI "void \fBaboutToShowPage\fP (\fBQWidget\fP *page)"
.br
.in -1c
.SS "Public Member Functions"

.in +1c
.ti -1c
.RI "\fBKJanusWidget\fP (\fBQWidget\fP *parent=0, const  char *name=0, int face=Plain)"
.br
.RI "\fIConstructor where you specify the face. \fP"
.ti -1c
.RI "\fB~KJanusWidget\fP ()"
.br
.RI "\fIDestructor. \fP"
.ti -1c
.RI "virtual bool \fBshowPage\fP (int index)"
.br
.RI "\fIRaises the page which was added by \fBaddPage\fP(). \fP"
.ti -1c
.RI "virtual int \fBactivePageIndex\fP () const "
.br
.RI "\fIReturns the index of the page that are currently displayed. \fP"
.ti -1c
.RI "virtual bool \fBisValid\fP () const "
.br
.RI "\fIUse this to verify that no memory allocation failed. \fP"
.ti -1c
.RI "virtual int \fBface\fP () const "
.br
.RI "\fIReturns the face type. \fP"
.ti -1c
.RI "virtual \fBQSize\fP \fBminimumSizeHint\fP () const "
.br
.RI "\fIReturns the minimum size that must be made available for the widget so that UIs can be displayed properly. \fP"
.ti -1c
.RI "virtual \fBQSize\fP \fBsizeHint\fP () const "
.br
.RI "\fIReturns the recommended size for the widget in order to be displayed properly. \fP"
.ti -1c
.RI "virtual \fBQFrame\fP * \fBplainPage\fP ()"
.br
.RI "\fIReturns the empty widget that is available in Plain mode. \fP"
.ti -1c
.RI "virtual \fBQFrame\fP * \fBaddPage\fP (const  \fBQString\fP &item, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIAdd a new page when the class is used in TreeList, IconList or Tabbed mode. \fP"
.ti -1c
.RI "virtual \fBQFrame\fP * \fBaddPage\fP (const  \fBQStringList\fP &items, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIThis is like addPage just above, with the difference that the first element is a list of strings. \fP"
.ti -1c
.RI "virtual \fBQVBox\fP * \fBaddVBoxPage\fP (const  \fBQString\fP &item, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIAdd a new page when the class is used in TreeList, IconList or Tabbed mode. \fP"
.ti -1c
.RI "virtual \fBQVBox\fP * \fBaddVBoxPage\fP (const  \fBQStringList\fP &items, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIThis is like addVBoxPage just above, with the difference that the first element is a list of strings. \fP"
.ti -1c
.RI "virtual \fBQHBox\fP * \fBaddHBoxPage\fP (const  \fBQString\fP &itemName, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIAdd a new page when the class is used in TreeList, IconList or Tabbed mode. \fP"
.ti -1c
.RI "virtual \fBQHBox\fP * \fBaddHBoxPage\fP (const  \fBQStringList\fP &items, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIThis is like addHBoxPage just above, with the difference that the first element is a list of strings. \fP"
.ti -1c
.RI "virtual \fBQGrid\fP * \fBaddGridPage\fP (int n, Orientation dir, const  \fBQString\fP &itemName, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIAdd a new page when the class is used in either TreeList or Tabbed mode. \fP"
.ti -1c
.RI "virtual \fBQGrid\fP * \fBaddGridPage\fP (int n, Orientation dir, const  \fBQStringList\fP &items, const  \fBQString\fP &header=QString::null, const  \fBQPixmap\fP &pixmap=\fBQPixmap\fP())"
.br
.RI "\fIThis is like addGridPage just above, with the difference that the first element is a list of strings. \fP"
.ti -1c
.RI "void \fBremovePage\fP (\fBQWidget\fP *page)"
.br
.RI "\fIRemoves a page created with \fBaddPage\fP, \fBaddVBoxPage\fP, \fBaddHBoxPage\fP or \fBaddGridPage\fP. If the page has already been deleted or has already been removed, nothing happens. The widget itself is not deleted. \fP"
.ti -1c
.RI "virtual int \fBpageIndex\fP (\fBQWidget\fP *widget) const "
.br
.RI "\fIReturns the index of a page created with \fBaddPage\fP , \fBaddVBoxPage\fP , \fBaddHBoxPage\fP or \fBaddGridPage\fP . \fP"
.ti -1c
.RI "virtual bool \fBsetSwallowedWidget\fP (\fBQWidget\fP *widget)"
.br
.RI "\fIDefines the widget to be swallowed. \fP"
.ti -1c
.RI "virtual void \fBsetTreeListAutoResize\fP (bool state)"
.br
.RI "\fIThis function has only effect in TreeList mode. \fP"
.ti -1c
.RI "virtual void \fBsetShowIconsInTreeList\fP (bool state)"
.br
.RI "\fIThis function has only effect in TreeList mode. \fP"
.ti -1c
.RI "virtual void \fBsetRootIsDecorated\fP (bool state)"
.br
.RI "\fIThis function has only effect in TreeList mode. \fP"
.ti -1c
.RI "virtual void \fBsetIconListAllVisible\fP (bool state)"
.br
.RI "\fIThis function has only effect in IconList mode. \fP"
.ti -1c
.RI "virtual void \fBsetFolderIcon\fP (const  \fBQStringList\fP &path, const  \fBQPixmap\fP &pixmap)"
.br
.RI "\fISets the icon used in TreeList Mode for the given path. \fP"
.in -1c
.SS "Protected Member Functions"

.in +1c
.ti -1c
.RI "virtual void \fBshowEvent\fP (\fBQShowEvent\fP *)"
.br
.RI "\fIReimplemented to handle the splitter width when the the face is TreeList. \fP"
.ti -1c
.RI "virtual bool \fBeventFilter\fP (\fBQObject\fP *o, \fBQEvent\fP *e)"
.br
.RI "\fIThis function is used internally when in IconList mode. \fP"
.ti -1c
.RI "bool \fBshowPage\fP (\fBQWidget\fP *w)"
.br
.ti -1c
.RI "void \fBaddPageWidget\fP (\fBQFrame\fP *page, const  \fBQStringList\fP &items, const  \fBQString\fP &header, const  \fBQPixmap\fP &pixmap)"
.br
.ti -1c
.RI "void \fBInsertTreeListItem\fP (const  \fBQStringList\fP &items, const  \fBQPixmap\fP &pixmap, \fBQFrame\fP *page)"
.br
.ti -1c
.RI "\fBQWidget\fP * \fBFindParent\fP ()"
.br
.ti -1c
.RI "virtual void \fBvirtual_hook\fP (int id, void *data)"
.br
.in -1c
.SH "Detailed Description"
.PP 
Provides a number of ready to use layouts (faces). Easy to use widget with many layouts. 

It is used as an internal widget in \fBKDialogBase\fP, but can also used as a widget of its own.
.PP
It provides TreeList, IconList, Tabbed, Plain and Swallow layouts.
.PP
The TreeList face provides a list in the left area and pages in the right. The area are separated by a movable splitter. The style is somewhat similar to the layout in the Control Center. A page is raised by selecting the corresponding tree list item.
.PP
The IconList face provides an icon list in the left area and pages in the right. For each entry the Icon is on top with the text below. The style is somewhat similar to the layout of the Eudora configuation dialog box. A page is raised by selecting the corresponding icon list item. The preferred icon size is 32x32 pixels.
.PP
The Tabbed face is a common tabbed widget. The procedure for creating a page is similar for creating a TreeList. This has the advantage that if your widget contain too many pages it is trivial to convert it into a TreeList. Just change the face in the KJanusWidget constructor to KJanusWidget::TreeList and you have a tree list layout instead.
.PP
The Plain face provides an empty widget (\fBQFrame\fP) where you can place your widgets. The KJanusWidget makes no assumptions regarding the contents so you are free to add whatever you want.
.PP
The Swallow face is provided in order to simplify the usage of existing widgets and to allow changing the visible widget. You specify the widget to be displayed by \fBsetSwallowedWidget\fP(). Your widget will be reparented inside the widget. You can specify a Null (0) widget. A empty space is then displayed.
.PP
For all modes it is important that you specify the \fBQWidget::minimumSize\fP() on the page, plain widget or the swallowed widget. If you use a \fBQLayout\fP on the page, plain widget or the swallowed widget this will be taken care of automatically. The size is used when the KJanusWidget determines its own minimum size. You get the minimum size by using the \fBminimumSizeHint\fP() or \fBsizeHint\fP() methods.
.PP
Pages that have been added in TreeList, IconList or Tabbed mode can be removed by simply deleting the page.
.PP
\fBAuthor:\fP
.RS 4
Espen Sand (espen@kde.org) 
.RE
.PP

.PP
Definition at line 89 of file kjanuswidget.h.
.SH "Constructor & Destructor Documentation"
.PP 
.SS "KJanusWidget::KJanusWidget (\fBQWidget\fP * parent = 0, const char * name = 0, int face = Plain)"
.PP
Constructor where you specify the face. \fBParameters:\fP
.RS 4
\fIparent\fP Parent of the widget. 
.br
\fIname\fP Widget name. 
.br
\fIint\fP face The kind of dialog, Use TreeList, Tabbed, Plain or Swallow. 
.RE
.PP
Definition at line 84 of file kjanuswidget.cpp.
.PP
References KListView::addColumn(), QString::fromLatin1(), QListView::header(), KDialog::marginHint(), KStdAccel::name(), QWidget::QWidget(), QFont::setBold(), QLabel::setFont(), QFrame::setFrameStyle(), QTabWidget::setMargin(), QListView::setRootIsDecorated(), KListView::setSorting(), setSwallowedWidget(), and KDialog::spacingHint().
.SS "KJanusWidget::~\fBKJanusWidget\fP ()"
.PP
Destructor. Definition at line 191 of file kjanuswidget.cpp.
.SH "Member Function Documentation"
.PP 
.SS "bool KJanusWidget::showPage (int index)\fC [virtual]\fP"
.PP
Raises the page which was added by \fBaddPage\fP(). \fBParameters:\fP
.RS 4
\fIindex\fP The index of the page you want to raise. 
.RE
.PP
Definition at line 565 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::showPage().
.SS "int KJanusWidget::activePageIndex () const\fC [virtual]\fP"
.PP
Returns the index of the page that are currently displayed. \fBReturns:\fP
.RS 4
The index or -1 if the face is not Tabbed, TreeList or IconList. 
.RE
.PP
Definition at line 631 of file kjanuswidget.cpp.
.PP
References QTabWidget::currentPage(), and QListView::selectedItem().
.PP
Referenced by KDialogBase::activePageIndex().
.SS "bool KJanusWidget::isValid () const\fC [virtual]\fP"
.PP
Use this to verify that no memory allocation failed. \fBReturns:\fP
.RS 4
true if the widget was properly created. 
.RE
.PP
Definition at line 197 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::KDialogBase().
.SS "int KJanusWidget::face () const\fC [virtual]\fP"
.PP
Returns the face type. \fBReturns:\fP
.RS 4
The face type. 
.RE
.PP
Definition at line 209 of file kjanuswidget.cpp.
.SS "\fBQSize\fP KJanusWidget::minimumSizeHint () const\fC [virtual]\fP"
.PP
Returns the minimum size that must be made available for the widget so that UIs can be displayed properly. \fBReturns:\fP
.RS 4
The minimum size. 
.RE
.PP
Reimplemented from \fBQWidget\fP.
.PP
Definition at line 740 of file kjanuswidget.cpp.
.PP
References QSize::height(), QWidget::minimumSize(), QSize::rheight(), QSize::rwidth(), KDialog::spacingHint(), QWidget::style(), and QSize::width().
.PP
Referenced by sizeHint().
.SS "\fBQSize\fP KJanusWidget::sizeHint () const\fC [virtual]\fP"
.PP
Returns the recommended size for the widget in order to be displayed properly. \fBReturns:\fP
.RS 4
The recommended size. 
.RE
.PP
Reimplemented from \fBQWidget\fP.
.PP
Definition at line 799 of file kjanuswidget.cpp.
.PP
References minimumSizeHint().
.SS "\fBQFrame\fP * KJanusWidget::plainPage ()\fC [virtual]\fP"
.PP
Returns the empty widget that is available in Plain mode. \fBReturns:\fP
.RS 4
The widget or 0 if the face in not Plain. 
.RE
.PP
Definition at line 203 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::plainPage().
.SS "\fBQFrame\fP * KJanusWidget::addPage (const \fBQString\fP & item, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. In most cases you must create a layout manager and associate it with this widget as well.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP String used in the list or Tab item. 
.br
\fIheader\fP A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead. 
.br
\fIpixmap\fP Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
.RE
.PP
\fBReturns:\fP
.RS 4
The empty page or 0 if the face is not TreeList, IconList or Tabbed. 
.RE
.PP
Definition at line 244 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::addPage().
.SS "\fBQFrame\fP * KJanusWidget::addPage (const \fBQStringList\fP & items, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
This is like addPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored. Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later. Definition at line 224 of file kjanuswidget.cpp.
.SS "\fBQVBox\fP * KJanusWidget::addVBoxPage (const \fBQString\fP & item, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a \fBQVBox\fP so it contains a \fBQVBoxLayout\fP layout that lines up the child widgets are vertically.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP String used in the list or Tab item. 
.br
\fIheader\fP A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead. 
.br
\fIpixmap\fP Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
.RE
.PP
\fBReturns:\fP
.RS 4
The empty page or 0 if the face is not TreeList, IconList or Tabbed. 
.RE
.PP
Definition at line 271 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::addVBoxPage().
.SS "\fBQVBox\fP * KJanusWidget::addVBoxPage (const \fBQStringList\fP & items, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
This is like addVBoxPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later. Definition at line 254 of file kjanuswidget.cpp.
.PP
References KDialog::spacingHint().
.SS "\fBQHBox\fP * KJanusWidget::addHBoxPage (const \fBQString\fP & itemName, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
Add a new page when the class is used in TreeList, IconList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a \fBQHBox\fP so it contains a \fBQHBoxLayout\fP layout that lines up the child widgets are horizontally.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.
.PP
\fBParameters:\fP
.RS 4
\fIitem\fP String used in the list or Tab item. 
.br
\fIheader\fP A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead. 
.br
\fIpixmap\fP Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
.RE
.PP
\fBReturns:\fP
.RS 4
The empty page or 0 if the face is not TreeList, IconList or Tabbed. 
.RE
.PP
Definition at line 296 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::addHBoxPage().
.SS "\fBQHBox\fP * KJanusWidget::addHBoxPage (const \fBQStringList\fP & items, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
This is like addHBoxPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later. Definition at line 280 of file kjanuswidget.cpp.
.PP
References QHBox::setSpacing(), and KDialog::spacingHint().
.SS "\fBQGrid\fP * KJanusWidget::addGridPage (int n, Orientation dir, const \fBQString\fP & itemName, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
Add a new page when the class is used in either TreeList or Tabbed mode. The returned widget is empty and you must add your widgets as children to this widget. The returned widget is a \fBQGrid\fP so it contains a \fBQGridLayout\fP layout that places up the child widgets in a grid.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later.
.PP
\fBParameters:\fP
.RS 4
\fIn\fP Specifies the number of columns if 'dir' is QGrid::Horizontal or the number of rows if 'dir' is QGrid::Vertical. 
.br
\fIdir\fP Can be QGrid::Horizontal or QGrid::Vertical. 
.br
\fIitem\fP String used in the list or Tab item. 
.br
\fIheader\fP A longer string used in TreeList and IconList mode to describe the contents of a page. If empty, the item string will be used instead. 
.br
\fIpixmap\fP Used in IconList mode or in TreeList mode. You should prefer a pixmap with size 32x32 pixels.
.RE
.PP
\fBReturns:\fP
.RS 4
The empty page or 0 if the face is not TreeList, IconList or Tabbed. 
.RE
.PP
Definition at line 324 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::addGridPage().
.SS "\fBQGrid\fP * KJanusWidget::addGridPage (int n, Orientation dir, const \fBQStringList\fP & items, const \fBQString\fP & header = QString::null, const \fBQPixmap\fP & pixmap = \fBQPixmap\fP())\fC [virtual]\fP"
.PP
This is like addGridPage just above, with the difference that the first element is a list of strings. These strings are used to form a path of folders down to the given page. The initial elements are names for the folders, while the last element is the name of the page. Note: This does yet only work for the TreeList face. Later this may be added for the IconList face too. In other faces than the TreeList, all the strings except the last one is ignored.
.PP
Deleting the returned frame will cause the listitem or tab to be removed (you can re-add a page with the same name later. Definition at line 305 of file kjanuswidget.cpp.
.PP
References QGrid::setSpacing(), and KDialog::spacingHint().
.SS "void KJanusWidget::removePage (\fBQWidget\fP * page)"
.PP
Removes a page created with \fBaddPage\fP, \fBaddVBoxPage\fP, \fBaddHBoxPage\fP or \fBaddGridPage\fP. If the page has already been deleted or has already been removed, nothing happens. The widget itself is not deleted. \fBParameters:\fP
.RS 4
\fIpage\fP The widget returned by \fBaddPage\fP , \fBaddVBoxPage\fP , \fBaddHBoxPage\fP or \fBaddGridPage\fP . 
.RE
.PP
Definition at line 1044 of file kjanuswidget.cpp.
.PP
References QMap< QListBoxItem *, QWidget * >::begin(), QMap< QListViewItem *, QWidget * >::begin(), QMap< QListBoxItem *, QWidget * >::end(), QMap< QListViewItem *, QWidget * >::end(), QMap< QListBoxItem *, QWidget * >::remove(), QMap< QListViewItem *, QWidget * >::remove(), QTabWidget::removePage(), and QWidgetStack::removeWidget().
.SS "int KJanusWidget::pageIndex (\fBQWidget\fP * widget) const\fC [virtual]\fP"
.PP
Returns the index of a page created with \fBaddPage\fP , \fBaddVBoxPage\fP , \fBaddHBoxPage\fP or \fBaddGridPage\fP . You can can compare this index with the value returned from \fBactivePageIndex\fP if you need to do some page specific actions in your code.
.PP
The returned index will never change so you can safely use this function once and save the value.
.PP
\fBParameters:\fP
.RS 4
\fIwidget\fP The widget returned by \fBaddPage\fP , \fBaddVBoxPage\fP , \fBaddHBoxPage\fP or \fBaddGridPage\fP .
.RE
.PP
\fBReturns:\fP
.RS 4
The index or -1 if the face is not Tabbed, TreeList or IconList 
.RE
.PP
Definition at line 655 of file kjanuswidget.cpp.
.PP
References QWidget::parentWidget().
.PP
Referenced by KDialogBase::pageIndex().
.SS "bool KJanusWidget::setSwallowedWidget (\fBQWidget\fP * widget)\fC [virtual]\fP"
.PP
Defines the widget to be swallowed. This method can be used several times. Only the latest defined widget will be shown.
.PP
\fBParameters:\fP
.RS 4
\fIwidget\fP The widget to be swallowed. If 0, then an empty rectangle is displayed. 
.RE
.PP
Definition at line 486 of file kjanuswidget.cpp.
.PP
References QGridLayout::addWidget(), QObject::isWidgetType(), QWidget::layout(), QWidget::minimumSize(), QWidget::reparent(), and QWidget::setMinimumSize().
.PP
Referenced by KJanusWidget(), and KDialogBase::setMainWidget().
.SS "void KJanusWidget::setTreeListAutoResize (bool state)\fC [virtual]\fP"
.PP
This function has only effect in TreeList mode. Defines how the tree list is resized when the widget is resized horizontally. By default the tree list keeps its width when the widget becomes wider.
.PP
\fBParameters:\fP
.RS 4
\fIstate\fP The resize mode. If false (default) the TreeList keeps its current width when the widget becomes wider. 
.RE
.PP
Definition at line 805 of file kjanuswidget.cpp.
.PP
References QSplitter::setResizeMode().
.PP
Referenced by KDialogBase::setTreeListAutoResize().
.SS "void KJanusWidget::setShowIconsInTreeList (bool state)\fC [virtual]\fP"
.PP
This function has only effect in TreeList mode. This tells the widgets whether the icons given in the \fBaddPage\fP, \fBaddVBoxPage\fP, \fBaddHBoxPage\fP, or \fBaddGridPage\fP methods should be shown in the TreeList.
.PP
Note: This method must be called before calling any of the methods which add icons to the page.
.PP
\fBParameters:\fP
.RS 4
\fIstate\fP If true the icons are shown. 
.RE
.PP
Definition at line 825 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::setShowIconsInTreeList().
.SS "void KJanusWidget::setRootIsDecorated (bool state)\fC [virtual]\fP"
.PP
This function has only effect in TreeList mode. This tells the widgets whether the root should be decorated. For details see \fBQListView::setRootIsDecorated\fP
.PP
\fBParameters:\fP
.RS 4
\fIstate\fP Root will be decorated if true. 
.RE
.PP
Definition at line 830 of file kjanuswidget.cpp.
.PP
References QListView::setRootIsDecorated().
.PP
Referenced by KDialogBase::setRootIsDecorated().
.SS "void KJanusWidget::setIconListAllVisible (bool state)\fC [virtual]\fP"
.PP
This function has only effect in IconList mode. Defines how the icon list widget is displayed. By default it is the widgets in the pages that decide the minimum height of the toplevel widget. A vertical scrollbar can be used in the icon list area.
.PP
\fBParameters:\fP
.RS 4
\fIstate\fP The visibility mode. If true, the minimum height is adjusted so that every icon in the list is visible at the same time. The vertical scrollbar will never be visible. 
.RE
.PP
Definition at line 817 of file kjanuswidget.cpp.
.PP
Referenced by KDialogBase::setIconListAllVisible().
.SS "void KJanusWidget::setFolderIcon (const \fBQStringList\fP & path, const \fBQPixmap\fP & pixmap)\fC [virtual]\fP"
.PP
Sets the icon used in TreeList Mode for the given path. \fBParameters:\fP
.RS 4
\fIpath\fP The path for which this icon should be shown. 
.br
\fIpixmap\fP The icon used. 
.RE
.PP
Definition at line 478 of file kjanuswidget.cpp.
.PP
References QMap< QString, QPixmap >::insert(), QStringList::join(), and KStdAccel::key().
.PP
Referenced by KDialogBase::setFolderIcon().
.SS "void KJanusWidget::setFocus ()\fC [virtual, slot]\fP"
.PP
Give the keyboard input focus to the widget. Reimplemented from \fBQWidget\fP.
.PP
Definition at line 714 of file kjanuswidget.cpp.
.PP
References QWidget::setFocus().
.SS "void KJanusWidget::showEvent (\fBQShowEvent\fP *)\fC [protected, virtual]\fP"
.PP
Reimplemented to handle the splitter width when the the face is TreeList. Reimplemented from \fBQWidget\fP.
.PP
Definition at line 838 of file kjanuswidget.cpp.
.PP
References QSplitter::setResizeMode().
.SS "bool KJanusWidget::eventFilter (\fBQObject\fP * o, \fBQEvent\fP * e)\fC [protected, virtual]\fP"
.PP
This function is used internally when in IconList mode. If you reimplement this class a make your own event filter, make sure to call this function from your filter.
.PP
\fBParameters:\fP
.RS 4
\fIo\fP Object that has received an event. 
.br
\fIe\fP The event. 
.RE
.PP
Definition at line 853 of file kjanuswidget.cpp.
.PP
References QEvent::type().

.SH "Author"
.PP 
Generated automatically by Doxygen for kdeui Library from the source code.
