|
|
A KDialogBase with predefined main widget.
As a KDialogBase it uses your application wide settings for KDialogBase objects (base frame tiles, main frame tiles etc). To use it, simply create a KAboutDialog object, set all (or some) of its properties and show it. Do not derive it to create your own about dialog until you need some cool features that are unsupported and you have contacted me to add them.
The dialog can be created using two different constructors. The difference between these constructors is the available components that can be used to build the contents of the dialog. The first (Constructor I) provides a number of easy to use methods. Basically it allows you to add the components of choice, and the components are placed in a predefined layout. You do not have to plan the layout. Everything is taken care of.
The second constructor (Constructor II) works in quite the same manner as the first, but you have better control on where the components are postioned in the layout and you have access to an extended number of components you can install such as titles, product information, a tabbed pages (where you can display rich text with url links) and a person (developer) information field. The "About KDE" dialog box is created with Constructor II.
For the derived features, see the basic class KDialogBase.
enum |
Layout formats.
|
The standard Qt constructor (Constructor I).
Add components with the following methods: setLogo(), setAuthor(), setMaintainer(), addContributor(), or setVersion(). The dialog will be laid out automatically.
|
The extended constructor. (Constructor II).
Add components with the methods: setTitle(), setImage(), setImageBackgroundColor(), setImageFrame(), setProduct(), addTextPage(), addContainerPage(), addContainer(), or addPage().
Parameters:
void |
Adjust the dialog.
You can call this method after you have set up all the contents but it is not required. It is done automatically when show() is executed.
void |
[virtual]
Make a modeless (modal = false in constructor) dialog visible.
If you reimplement this method make sure you run it in the new method (e.g., show()). Reimplemented from KDialogBase.
void |
[virtual]
Make a modless (modal = false in constructor) dialog visible.
If you reimplmement this method make sure you run it in the new method (i.e., show( parent )).
Parameters:
void |
(Constructor II only) Set a title (not caption) in the uppermost area of the dialog
Parameters:
void |
(Constructor II only)
Define an image to be shown in the dialog. The position is dependent
on the dialogLayout
in the constructor
Parameters:
void |
(Constructor II only) The image has a minimum size, but is centered within an area if the dialog box is enlarged by the user. You set the background color of the area with this method.
Parameters:
void |
(Constructor II only) Enable or disable a frame around the image. The frame is, by default, enabled in the constructor
Parameters:
void |
(Constructor II only) Print the application name, KDE version, author, a copyright sign and a year string. To the left of the text the standard application icon is displayed.
Parameters:
QFrame * |
(Constructor II only) Add a text page to a tab box. The text can be regular text or rich text. The rich text can contain URLs and mail links.
Parameters:
Returns: The frame that contains the page.
QFrame * |
(Constructor II only) Add a license page to a tab box.
Parameters:
Returns: The frame that contains the page.
KAboutContainer * |
(Constructor II only) Adds a container to a tab box. You can add text and images to a container.
Parameters:
Returns: The new container.
KAboutContainer * |
(Constructor II only) Adds a container inside a QScrollView to a tab box. You can add text and images to a container.
Parameters:
Returns: The new container.
KAboutContainer * |
(Constructor II only) Add a container. You can add text and images to a container.
Parameters:
Returns: The new container.
QFrame * |
(Constructor II only) Adds an empty page to a tab box.
Parameters:
Returns: The new page.
Reimplemented from KDialogBase.
void |
(Constructor I only) Set the image as the application logo.
void |
(Constructor I only) Set the author's name and email address.
void |
(Constructor I only) Set the maintainer's name and email address.
void |
(Constructor I only) Show this person as one of the major contributors.
void |
(Constructor I only) Set the text describing the version.
void |
[static]
Create a modal dialog with an image in the upper area with a URL link below.
void |
[signal]
Send an email to this person.
The application must provide the functionality.
void |
[signal]
Open the selected URL.
KAboutWidget * |
[protected]
The main widget (Constructor I)
KAboutContainerBase * |
[protected]
The main widget (Constructor II)
void |
[protected slot]
Connected to widget->sendEmail.
void |
[protected slot]
Open this URL.
void |
[protected virtual slot]
(Constructor II only) Tells the position of the mouse cursor when the left mouse button is pressed above an image