KPropertiesDialog Class Reference
#include <kpropertiesdialog.h>
Detailed Description
The main properties dialog class.A Properties Dialog is a dialog which displays various information about a particular file or URL, or several files or URLs. This main class holds various related classes, which are instantiated in the form of tab entries in the tabbed dialog that this class provides. The various tabs themselves will let the user view, and sometimes change, information about the file or URL.

Typical KProperties Dialog
If you are looking for more flexibility, see KFileMetaInfo and KFileMetaInfoWidget.
Definition at line 70 of file kpropertiesdialog.h.
Public Slots | |
virtual void | slotOk () |
virtual void | slotCancel () |
Signals | |
void | propertiesClosed () |
void | applied () |
void | canceled () |
void | saveAs (const KURL &oldUrl, KURL &newUrl) |
Public Member Functions | |
KPropertiesDialog (KFileItem *item, QWidget *parent=0L, const char *name=0L, bool modal=false, bool autoShow=true) | |
KPropertiesDialog (KFileItemList _items, QWidget *parent=0L, const char *name=0L, bool modal=false, bool autoShow=true) | |
KPropertiesDialog (const KURL &_url, mode_t _mode, QWidget *parent=0L, const char *name=0L, bool modal=false, bool autoShow=true) KDE_DEPRECATED | |
KPropertiesDialog (const KURL &_url, QWidget *parent=0L, const char *name=0L, bool modal=false, bool autoShow=true) | |
KPropertiesDialog (const KURL &_tempUrl, const KURL &_currentDir, const QString &_defaultName, QWidget *parent=0L, const char *name=0L, bool modal=false, bool autoShow=true) | |
KPropertiesDialog (const QString &title, QWidget *parent=0L, const char *name=0L, bool modal=false) | |
virtual | ~KPropertiesDialog () |
void | insertPlugin (KPropsDlgPlugin *plugin) |
const KURL & | kurl () const |
KFileItem * | item () |
KFileItemList | items () const |
KDE_DEPRECATED KDialogBase * | dialog () |
KDE_DEPRECATED const KDialogBase * | dialog () const |
const KURL & | currentDir () const |
const QString & | defaultName () const |
void | updateUrl (const KURL &_newUrl) |
void | rename (const QString &_name) |
void | abortApplying () |
void | showFileSharingPage () |
void | setFileSharingPage (QWidget *page) |
void | setFileNameReadOnly (bool ro) |
Static Public Member Functions | |
static bool | canDisplay (KFileItemList _items) |
static bool | showDialog (KFileItem *item, QWidget *parent=0, const char *name=0, bool modal=false) |
static bool | showDialog (const KURL &_url, QWidget *parent=0, const char *name=0, bool modal=false) |
static bool | showDialog (const KFileItemList &_items, QWidget *parent=0, const char *name=0, bool modal=false) |
Protected Member Functions | |
virtual void | virtual_hook (int id, void *data) |
Constructor & Destructor Documentation
|
Brings up a Properties dialog, as shown above. This is the normal constructor for file-manager type applications, where you have a KFileItem instance to work with. Normally you will use this method rather than the one below.
Definition at line 174 of file kpropertiesdialog.cpp. |
|
This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. You use this constructor for cases where you have a number of items, rather than a single item. Be careful which methods you use when passing a list of files or URLs, since some of them will only work on the first item in a list.
Definition at line 202 of file kpropertiesdialog.cpp. |
|
Definition at line 228 of file kpropertiesdialog.cpp. |
|
Brings up a Properties dialog. Convenience constructor for non-file-manager applications, where you have a KURL rather than a KFileItem or KFileItemList.
Definition at line 248 of file kpropertiesdialog.cpp. |
|
Creates a properties dialog for a new .desktop file (whose name is not known yet), based on a template. Special constructor for "File / New" in file-manager type applications.
Definition at line 267 of file kpropertiesdialog.cpp. |
|
Creates an empty properties dialog (for applications that want use a standard dialog, but for things not doable via the plugin-mechanism).
Definition at line 191 of file kpropertiesdialog.cpp. |
|
Cleans up the properties dialog and frees any associated resources, including the dialog itself. Note that when a properties dialog is closed it cleans up and deletes itself. Definition at line 367 of file kpropertiesdialog.cpp. |
Member Function Documentation
|
To abort applying changes.
Definition at line 588 of file kpropertiesdialog.cpp. |
|
This signal is emitted when the properties changes are applied (for example, with the OK button).
|
|
This signal is emitted when the properties changes are aborted (for example, with the Cancel button).
|
|
Determine whether there are any property pages available for the given file items.
Definition at line 381 of file kpropertiesdialog.cpp. |
|
If the dialog is being built from a template, this method returns the current directory. If no template, it returns QString::null. See the template form of the constructor.
Definition at line 287 of file kpropertiesdialog.h. |
|
If the dialog is being built from a template, this method returns the default name. If no template, it returns QString::null. See the template form of the constructor.
Definition at line 295 of file kpropertiesdialog.h. |
|
Definition at line 278 of file kpropertiesdialog.h. |
|
Definition at line 273 of file kpropertiesdialog.h. |
|
Adds a "3rd party" properties plugin to the dialog. Useful for extending the properties mechanism. To create a new plugin type, inherit from the base class KPropsDlgPlugin and implement all the methods. If you define a service .desktop file for your plugin, you do not need to call insertPlugin().
Definition at line 373 of file kpropertiesdialog.cpp. |
|
Definition at line 262 of file kpropertiesdialog.h. |
|
Definition at line 267 of file kpropertiesdialog.h. |
|
The URL of the file that has its properties being displayed. This is only valid if the KPropertiesDialog was created/shown for one file or URL.
Definition at line 253 of file kpropertiesdialog.h. |
|
This signal is emitted when the Properties Dialog is closed (for example, with OK or Cancel buttons).
|
|
Renames the item to the specified name. This can only be called if the dialog applies to a single file or URL.
Definition at line 565 of file kpropertiesdialog.cpp. |
|
Emitted before changes to
The receiver may change |
|
Call this to make the filename lineedit readonly, to prevent the user from renaming the file.
Definition at line 349 of file kpropertiesdialog.cpp. |
|
Sets the file sharing page. This page is shown when calling showFileSharingPage().
Definition at line 344 of file kpropertiesdialog.cpp. |
|
Immediately displays a Properties dialog using constructor with the same parameters.
On MS Windows, if
Definition at line 312 of file kpropertiesdialog.cpp. |
|
Immediately displays a Properties dialog using constructor with the same parameters.
On MS Windows, if
Definition at line 301 of file kpropertiesdialog.cpp. |
|
Immediately displays a Properties dialog using constructor with the same parameters.
On MS Windows, if
Definition at line 289 of file kpropertiesdialog.cpp. |
|
Shows the page that was previously set by setFileSharingPage(), or does nothing if no page was set yet.
Definition at line 337 of file kpropertiesdialog.cpp. |
|
Called when the user presses 'Cancel'.
Definition at line 439 of file kpropertiesdialog.cpp. |
|
Called when the user presses 'Ok'.
Definition at line 394 of file kpropertiesdialog.cpp. |
|
Updates the item URL (either called by rename or because a global apps/mimelnk desktop file is being saved) Can only be called if the dialog applies to a single file or URL.
Definition at line 541 of file kpropertiesdialog.cpp. |
The documentation for this class was generated from the following files: