|
|
The main properties dialog class. A Properties Dialog is a dialog which displays various information about a particular file or URL. 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 or change information about the file or URL.
This class must be created with (void)new PropertiesDialog(...) It will take care of deleting itself.
bool |
[static]
Returns: whether there are any property pages available for the given file items
|
Bring up a Properties dialog. Normal constructor for file-manager-like applications. Normally you will use this method rather than the one below.
Parameters:
item | file item whose properties should be displayed. |
parent | is the parent of the dialog widget. |
name | is the internal name. |
modal | tells the dialog whether it should be modal. |
autoShow | tells the dialog whethr it should show itself automatically. |
|
Bring up a Properties dialog. Normal constructor for file-manager-like applications.
Parameters:
_items | list of file items whose properties should be displayed. NOTE : the current limitations of PropertiesDialog makes it use only the FIRST item in the list. This method is provided for future expansion when the properties dialog may be able to get/set properties for a group of items all at once. |
parent | is the parent of the dialog widget. |
name | is the internal name. |
modal | tells the dialog whether it should be modal. |
autoShow | tells the dialog whethr it should show itself automatically. |
|
Bring up a Properties dialog. Convenience constructor for non-file-manager applications.
Parameters:
_url | the URL whose properties should be displayed |
_mode | the mode, as returned by stat(). Don't set if unknown. |
parent | is the parent of the dialog widget. |
name | is the internal name. |
modal | tells the dialog whether it should be modal. |
autoShow | tells the dialog whethr it should show itself automatically. |
|
Create 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 applications.
Parameters:
_templUrl | template used for reading only |
_currentDir | directory where the file will be written to |
_defaultName | something to put in the name field, like mimetype.desktop |
parent | is the parent of the dialog widget. |
name | is the internal name. |
modal | tells the dialog whether it should be modal. |
autoShow | tells the dialog whethr it should show itself automatically. |
|
Create an empty properties dialog (for applications that want use a standard dialog, but for things not doable via the plugin-mechanism.
Parameters:
title | is the string display as the "filename" in the caption of the dialog. |
parent | is the parent of the dialog widget. |
name | is the internal name. |
modal | tells the dialog whether it should be modal. |
~ |
[virtual]
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.
void |
Adds a "3rd party" properties plugin to the dialog. Useful for extending the properties mechanism.
To create a new lugin type, inherit from the base class KPropsPlugin and implement all the methods.
Parameters:
plugin | is a pointer to the PropsPlugin. The Properties dialog will do destruction for you. The KPropsPlugin MUST have been created with the KPropertiesDialog as its parent. |
const KURL& |
[const]
Returns: a parsed URL. Valid only if dialog shown for one file/url.
KFileItem * |
Returns: the file item for which the dialog is shown HACK : returns the first item of the list
KFileItemList |
[const]
KDialogBase* |
Returns: a pointer to the dialog
const KDialogBase* |
[const]
const KURL& |
[const]
If we are building this dialog from a template,
Returns: the current directory QString::null means no template used
const QString& |
[const]
If we are building this dialog from a template,
Returns: the default name (see 3rd constructor) QString::null means no template used
void |
Updates the item url (either called by rename or because a global apps/mimelnk desktop file is being saved)
Parameters:
_name | new URL |
void |
#see FilePropsPlugin::applyChanges
Parameters:
_name | new filename, encoded. |
void |
To abort applying changes
void |
[slot]
Called when the user presses 'Ok'.
Reimplemented from KDialogBase.
void |
[slot]
Reimplemented from KDialogBase.
void |
[signal]
Notify that we have finished with the properties (be it Apply or Cancel)
void |
[signal]
void |
[signal]
Generated by: prospector@porky.devel.redhat.com on Thu Aug 24 05:36:13 2000, using kdoc 2.0a36. |