Development/Architecture/KDE3/KFile Library - Revision history

Neverendingo: Text replace - "" to ""

2011-06-29T20:49:34Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:35:04Z
Text replace - "<code cppqt3>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:35, 29 June 2011
			
Line 36:
Line 36:
  are shown as clear text. For example:   are shown as clear text. For example:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  KURL u(QDir::homeDirPath());   KURL u(QDir::homeDirPath());
  QString text = i18n("Home Directory");   QString text = i18n("Home Directory");
Line 51:
Line 51:
  of the following form:   of the following form:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  combo->setFilter("*.cpp|Implementation files\n*.h|Header files");   combo->setFilter("*.cpp|Implementation files\n*.h|Header files");
  </code>   </code>
Line 58:
Line 58:
  according patterns. The other method is to give a list of MIME types:   according patterns. The other method is to give a list of MIME types:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  QStringList mimeTypes;   QStringList mimeTypes;
  mimeTypes << "image/png";   mimeTypes << "image/png";
Line 85:
Line 85:
  [http://api.kde.org/3.5-api/kdelibs-apidocs/kdeui/html/classKComboBox.html KComboBox]):   [http://api.kde.org/3.5-api/kdelibs-apidocs/kdeui/html/classKComboBox.html KComboBox]):
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  KCompletion *completion =   KCompletion *completion =
       new KURLCompletion(KURLCompletion::ExeCompletion);        new KURLCompletion(KURLCompletion::ExeCompletion);
Line 102:
Line 102:
  can be easily added:   can be easily added:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  KPixmapProver *pixmapProvider = new KURLPixmapProvider();   KPixmapProver *pixmapProvider = new KURLPixmapProvider();
  comboBox->setPixmapProvider(pixmapProvider);   comboBox->setPixmapProvider(pixmapProvider);



Dhaumann: Development/Architecture/KDE 3 Architecture/KFile Library moved to Development/Architecture/KDE3/KFile Library
2007-03-11T21:35:52Z
Development/Architecture/KDE 3 Architecture/KFile Library moved to Development/Architecture/KDE3/KFile Library

			
			← Older revision
			Revision as of 21:35, 11 March 2007
			


Dhaumann: Category:Architecture
2007-01-23T09:36:05Z
Category:Architecture

				
				
				
				
			
			← Older revision
			Revision as of 09:36, 23 January 2007
			
Line 153:
Line 153:
    
  [[Category:KDE3]]   [[Category:KDE3]]
  + [[Category:Architecture]]



CuCullin: Category KDE3
2007-01-10T02:32:51Z
Category KDE3

				
				
				
				
			
			← Older revision
			Revision as of 02:32, 10 January 2007
			
Line 151:
Line 151:
    
  ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]   ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]
  + 
  + [[Category:KDE3]]



Dhaumann: fix image size
2007-01-07T20:52:12Z
fix image size

				
				
				
				
			
			← Older revision
			Revision as of 20:52, 7 January 2007
			
Line 11:
Line 11:
  dialog for separate use.   dialog for separate use.
    
− [[Image:k3filedialog-widgets.png|frame|center|KFileDialog widgets]] + [[Image:k3filedialog-widgets.png|thumb|center|500px|KFileDialog widgets]]
    
  === KDirOperator ===   === KDirOperator ===



Dhaumann: port of http://developer.kde.org/documentation/library/kdeqt/kde3arch/kfile.html
2007-01-07T20:49:01Z
port of http://developer.kde.org/documentation/library/kdeqt/kde3arch/kfile.html
New page
KDE's file dialogs are implemented in the {{path|kfile}} library, which also

contains other widgets.



== File Dialog ==



The classes related to the file dialog are really a file dialog construction

set, i.e. the API not only contain the class 

[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKFileDialog.html KFileDialog] 

with its conveniently usable functions to obtain file names for saving or 

opening, but it also offers the various single widgets that constitute the 

dialog for separate use.



[[Image:k3filedialog-widgets.png|frame|center|KFileDialog widgets]]



=== KDirOperator ===



The main view of the file dialog is a 

[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKDirOperator.html KDirOperator]. 

It is a general browser for files and directories. How these lists and

trees are actually represented is configurable by the user. All widgets 

possible for this are derived from the class KFileView. These are the 

following:



*[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKFileIconView.html KFileIconView]: Corresponds to selecting "Short view" and "Single view" from the View submenu.

*[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKFileDetailView.html KFileDetailView]: Corresponds to selecting "Detailed view" and "Single view" from the View submenu.

*[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKCombiView.html KCombiView]: Corresponds to selecting "Separate directories" from the View submenu. This is a splitter widget which displays a KFileIconView (see above) on the left side and either a KFileIconView (if "Short view" is selected) or a KFileDetailView (if "Detailed view" is selected) on the right side.

*[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKFilePreview.html KFilePreview]: Corresponds to selecting "Preview" from the View submenu. This is also a splitter, which shows a KFileIconView (if "Short view" is selected) or a KFileDetailView (if "Detailed view" is selected) on the left side and a widget derived from KPreviewWidgetBase on the right side. By default, the widget on the right side is a KImagePreviewWidget, but this can be changed. This should be very rarely necessary, because the KImagePreviewWidget uses a mechanism for obtaining preview images (also known as ''thumbnails'') which can be extended by installing additional ThumbCreator services. In this way, the same preview images can also be used by Konqueror's icon view.



=== KURLComboBox ===



This is a combo box for selecting from a number of files and directories.

It runs in one of three modes. The KURLComboBox at the top of the file

dialog is in "Directories" mode, the one at the bottom in "Files" mode.

Items in the popup menu are shown as URLs together with their MIME type 

icon. Additionally, one can add a number of ''default items'' which

are shown as clear text. For example:



<code cppqt3>

KURL u(QDir::homeDirPath());

QString text = i18n("Home Directory");

QPixmap pixmap = KMimeType::pixmapForURL(u, 0, KIcon::Small);

combobox->addDefaultURL(u, pixmap, text);

</code>



=== KFileFilter ===



This is a combo box for selecting from a number of file filters

or MIME types. There are two ways to populate it with items:



First, you can give a linebreak-separated list of strings

of the following form:



<code cppqt3>

combo->setFilter("*.cpp|Implementation files\n*.h|Header files");

</code>



This displays the clear text strings in the popup in order to select the 

according patterns. The other method is to give a list of MIME types:



<code cppqt3>

QStringList mimeTypes;

mimeTypes << "image/png";

mimeTypes << "text/html";

combo->setMimeFilter(mimeTypes);

</code>



== Other widgets ==



Apart from the widgets used in the file dialog, there is a number of related

classes (partially contained in the ksycoca library):



=== KURLCompletion ===



This is a subclass of 

[http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/classKCompletion.html KCompletion]

and specifically designed to provide automatic completions for URLs. 

It can operate in one of two modes: <tt>ExeCompletion</tt> completes names

of executables by searching them in $PATH (if they are not given as

absolute file names). <tt>FileCompletion</tt> completes generic URLs.

This works even for remote addresses. 



Completion support can easily be added to line edits (derived from

[http://api.kde.org/3.5-api/kdelibs-apidocs/kdeui/html/classKLineEdit.html KLineEdit])

or combo boxes (derived from

[http://api.kde.org/3.5-api/kdelibs-apidocs/kdeui/html/classKComboBox.html KComboBox]):



<code cppqt3>

KCompletion *completion =

    new KURLCompletion(KURLCompletion::ExeCompletion);

lineEdit->setCompletionObject(completion);

lineEdit->setAutoDeleteCompletionObject(true);

</code>



=== KURLPixmapProvider ===



This is a subclass of

[http://api.kde.org/3.5-api/kdelibs-apidocs/kdecore/html/classKPixmapProvider.html KPixmapProvider]

which resolves pixmaps for URLs.



Support for URL icons in combo boxes (derived from

[http://api.kde.org/3.5-api/kdelibs-apidocs/kdeui/html/classKComboBox.html KComboBox])

can be easily added:



<code cppqt3>

KPixmapProver *pixmapProvider = new KURLPixmapProvider();

comboBox->setPixmapProvider(pixmapProvider);

</code>



=== KURLRequester ===



This is a lineedit combined with a button that invokes a file dialog. 

It uses the KURLCompletion class described above.



=== KURLRequesterDlg ===



A simple dialog for letting the user input a file name or URL. It is

a very thin wrapper around the KURLRequester widget. For example, this 

is used when you choose "Location->Open Location" in Konqueror.



=== KOpenWithDlg ===



The dialog shown by Konqueror when you click on a file with unknown

MIME type.



=== KPropertiesDialog ===



The properties dialog you get when you choose the "Properties" item from

Konqueror's context menu or the context menu in the file dialog. The

dialog can be extended with more tabs by inserting additional

[http://api.kde.org/3.5-api/kdelibs-apidocs/kio/kfile/html/classKPropsDlgPlugin.html KPropsDlgPlugin])

widgets.



=== KIconDialog ===



A dialog for selecting icons.



Furthermore, a number of additional IO jobs:



=== KDirSize ===



This computes the sum of the file sizes in a directory.



=== KDiskFreeSp ===



A class for finding out the free disk space on a disk.



=== KIO::PreviewJob ===



A job for creating thumbnails for a set of files.





''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]

← Older revision		Revision as of 09:36, 23 January 2007
Line 153:		Line 153:

	[[Category:KDE3]]		[[Category:KDE3]]
		+	[[Category:Architecture]]

← Older revision		Revision as of 02:32, 10 January 2007
Line 151:		Line 151:

	''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]		''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]
		+
		+	[[Category:KDE3]]