KPropDlg Class Reference

[kpropdlg Index] [kpropdlg Hierarchy] [Headers]


This class provides a property dialog More...

#include <../kpropdlg.h>

Inherits: QDialog

Public Members

Public Slots

Protected Members

Protected Slots

Signals


Detailed Description

This class provides a property dialog. Tree list, Tabs, or wizard type dialogs are supported. Methods for adding and showing pages have been kept public, allthough sub-Classing it is strongly recommended. to use the auto-config update connect your widgets need to have setConfig and getConfig() slots. Connect them in the KPropDlg subclass with connectConfig( YourWidget ).


KPropDlg( int dlgtype, int buttons, const char *title, QWidget *parent, const char *name=0, bool modal=TRUE ) [public]

Create a dialog with Tree or Tab support, and any combination of Previous, Next, Apply, OK, and Cancel buttons.

QFrame* addPage( int parentpage, const char *title, int position=0 ) [public]

Add a page to the dialog. If parentpage is omitted, the page will be added at the top level. If the position in the list is omitted, the page will be appended at the end. Returns a QFrame which can hold the page contents.

bool removePage( char *page=0, int index=0 ) [public]

Remove a page from the dialog. Give either the name of the index of the page. Returns TRUE on success, FALSE on error.

void showPage( QWidget *w ) [public]

Display a specific page of the property dialog. (By widget as opposedto by index so hose inheriting us don't have to worry about harding constants for the first exposure.)

void connectButtons(int buttons = OK|APPLY|CANCEL|PREV|NEXT ) [public]

connect Buttons to default handlers

void receiveOK() [public slot]

Receive indication that button was select and emit appropriatesignals. These methods may be reimplemented to change button behaviour.

void setButtonsEnabled( int types ) [public slot]

Set Button to use in the dialog. Button types can be a combination of: PREVIOUS, NEXT, OK, APPLY, CANCEL.

void setButton( int type, const char *text ) [public slot]

Set the button text.

void setDefaultButton( int type ) [public slot]

Set the default button, which is activated by pressing the return key.

bool showPage( int index ) [public slot]

For Tree layout, when highlighted, display page based on index.This seems not possible with a tab control

void connectConfig( QObject * propconf ) [public slot]

connect the Config object to the setConfig() and getConfig() slots

void resizeButtons() [protected]

Size the buttons and correct the size change for Motif default buttons.

int pageListStatus() [protected]

Read the status of the PageList. Can be one of the following:NOLIST, NOPAGES, NOCURRENT, or a combination of LASTPAGE, FIRSTPAGE.

void slotPrev() [protected slot]

Slot for simple Prev button action: previous page

void slotNext() [protected slot]

Slot for simple Next button action: next page

void acceptConfig() [protected slot virtual]

Accept the settings and close the dialog. calls setConfig()

void cancelConfig() [protected slot virtual]

Cancel and close the dialog.

void applyConfig() [protected slot virtual]

Apply the changes, do NOT close the dialog

void ApplyClicked() [signal]

Raise signals when one of the button types are clicked.

void configChanged() [signal]

This signal is emitted when Apply or OK is clicked, to indicate that the KConfig object has been modified.

void setConfig() [signal]

setConfig() and getConfig() can be connected to any child widgetsusing connectConfig(), to enable automatic config updating.


Documentation generated by fester@cal040052 on Sat Oct 10 12:30:32 /etc/localtime 1998
Kdoc