# class KPageWidgetItem

###

Module | kdeui
Namespace |
Class | KPageWidgetItem
Inherits | QObject

KPageWidgetItem is used by KPageWidget and represents a page.

Example:\n

    ColorPage *page = new ColorPage;

    KPageWidgetItem *item = new KPageWidgetItem( page, i18n( "Colors" ) );
    item->setHeader( i18n( "Colors of Main Window" ) );
    item->setIcon( KIcon( "colors" ) );

    KPageWidget *pageWidget = new KPageWidget( this );
    pageWidget->addPage( item );

Author Tobias Koenig (tokoe@kde.org)

### methods

- KPageWidgetItem (widget)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  widget | QWidget |

  Creates a new page widget item.

  widget - The widget that is shown as page in the KPageWidget.

- KPageWidgetItem (widget, name)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  widget | QWidget |
  name | QString |

  Creates a new page widget item.

  widget - The widget that is shown as page in the KPageWidget.

  name - The localized string that is show in the navigation view of the KPageWidget.

- changed ( )

  returns Nothing
  SIGNAL ("changed ()")

  This signal is emitted whenever the icon or header is changed.

- header ( )

  returns QString

  Returns the header of the page widget item.

- icon ( )

  returns KIcon

  Returns the icon of the page widget item.

- isCheckable ( )

  returns bool

  Returns whether the page widget item is checkable.

- isChecked ( )

  returns bool

  Returns whether the page widget item is checked.

- isEnabled ( )

  returns bool

  Returns whether the page widget item is enabled.

- name ( )

  returns QString

  Returns the name of the page widget item.

- setCheckable (checkable)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  checkable | bool |

  Sets whether the page widget item is checkable in the view.

  checkable - True if the page widget is checkable, otherwise false.

- setChecked (checked)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  checked | bool |

  Sets whether the page widget item is checked.

- setEnabled (a0)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  a0 | bool |

  Sets whether the page widget item is enabled.

- setHeader (header)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  header | QString |

  Sets the header of the page widget item.

  If setHeader(QString()) is used, what is the default if the header does not got set explicit, then the defined name() will also be used for the header. If setHeader("") is used, the header will be hidden even if the KPageView.FaceType is something else then Tabbed.

  header - Header of the page widget item.

- setIcon (icon)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  icon | KIcon |

  Sets the icon of the page widget item.

  icon - Icon of the page widget item.

- setName (name)

  returns Nothing

  Argument | Type | Default
  --- | --- | ---
  name | QString |

  Sets the name of the item as shown in the navigation view of the page widget.

- toggled (checked)

  returns Nothing
  SIGNAL ("toggled (bool)")

  Argument | Type | Default
  --- | --- | ---
  checked | bool |

  This signal is emitted whenever the user checks or unchecks the item of

  See also setChecked() is called.

- widget ( )

  returns QWidget

  Returns the widget of the page widget item.