KTipDialog Class Reference

A Tip-of-the-Day dialog. More...

#include <ktip.h>

Inheritance diagram for KTipDialog:

[legend]

List of all members.

Public Member Functions
	KTipDialog (KTipDatabase *db, QWidget *parent=0, const char *name=0)
	~KTipDialog ()
Static Public Member Functions
static void	setShowOnStart (bool show)
static void	showMultiTip (QWidget *parent, const QStringList &tipFiles, bool force=false)
static void	showTip (const QString &tipFile=QString::null, bool force=false)
static void	showTip (QWidget *parent, const QString &tipFile=QString::null, bool force=false)
Protected Member Functions
bool	eventFilter (QObject *, QEvent *)
virtual void	virtual_hook (int id, void *data)

---

Detailed Description

A Tip-of-the-Day dialog.

This dialog class presents a tip-of-the-day.

Author:

Matthias Hoelzer-Kluepfel <mhk@caldera.de>

Definition at line 108 of file ktip.h.

---

Constructor & Destructor Documentation

KTipDialog::KTipDialog	(	KTipDatabase *	db,
		QWidget *	parent = 0,
		const char *	name = 0
	)

Construct a tip dialog.

Parameters:

	db	TipDatabase that should be used by the TipDialog.
	parent	Parent widget of TipDialog.
	name	The object name.

Parent is 0L when TipDialog is used as a mainWidget. This should be the case only in ktip, so let's use the ktip layout.

Definition at line 171 of file ktip.cpp.

KTipDialog::~KTipDialog

(

)

Definition at line 317 of file ktip.cpp.

---

Member Function Documentation

bool KTipDialog::eventFilter	(	QObject *	o,
		QEvent *	e
	)			[protected]

Definition at line 403 of file ktip.cpp.

void KTipDialog::setShowOnStart

(

bool

show

)

[static]

Toggles the start behavior.

Normally, the user can disable the display of the tip in the dialog. This is just a way to change this setting from outside.

Definition at line 396 of file ktip.cpp.

void KTipDialog::showMultiTip	(	QWidget *	parent,
		const QStringList &	tipFiles,
		bool	force = false
	)			[static]

Shows a tip.

This method behaves essentially as the one above, but expects a list of tips

Parameters:

	parent	Parent widget of TipDialog.
	tipFiles	A List of tip files. Each has be relative to the "data" resource of KStandardDirs
	force	If true, the dialog is show, even when the users disabled it.

Definition at line 333 of file ktip.cpp.

void KTipDialog::showTip	(	const QString &	tipFile = QString::null,
		bool	force = false
	)			[static]

Shows a tip.

This methods calls showTip() with the applications main window as parent.

Definition at line 323 of file ktip.cpp.

void KTipDialog::showTip	(	QWidget *	parent,
		const QString &	tipFile = QString::null,
		bool	force = false
	)			[static]

Shows a tip.

This static method is all that is needed to add a tip-of-the-day dialog to an application. It will pop up the dialog, unless the user has asked that the dialog does not pop up on startup.

Note that you probably want an item in the help menu calling this method with force=true.

Parameters:

	parent	Parent widget of TipDialog.
	tipFile	The name of the tip file. It has be relative to the "data" resource of KStandardDirs
	force	If true, the dialog is show, even when the users disabled it.

Definition at line 328 of file ktip.cpp.

void KTipDialog::virtual_hook	(	int	id,
		void *	data
	)			[protected, virtual]

Reimplemented from KDialog.

Definition at line 419 of file ktip.cpp.

---

The documentation for this class was generated from the following files:

• ktip.h
• ktip.cpp