• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KIO

kfileitem.h

Go to the documentation of this file.
00001 /* This file is part of the KDE project
00002    Copyright (C) 1999-2006 David Faure <faure@kde.org>
00003 
00004    This library is free software; you can redistribute it and/or
00005    modify it under the terms of the GNU Library General Public
00006    License as published by the Free Software Foundation; either
00007    version 2 of the License, or (at your option) any later version.
00008 
00009    This library is distributed in the hope that it will be useful,
00010    but WITHOUT ANY WARRANTY; without even the implied warranty of
00011    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00012    Library General Public License for more details.
00013 
00014    You should have received a copy of the GNU Library General Public License
00015    along with this library; see the file COPYING.LIB.  If not, write to
00016    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
00017    Boston, MA 02110-1301, USA.
00018 */
00019 
00020 #ifndef KFILEITEM_H
00021 #define KFILEITEM_H
00022 
00023 #include <sys/stat.h>
00024 
00025 #include <kio/global.h>
00026 #include <kio/udsentry.h>
00027 #include <kurl.h>
00028 
00029 #include <kacl.h>
00030 #include <kmimetype.h>
00031 #include <kfilemetainfo.h>
00032 #include <kdatetime.h>
00033 #include <QtCore/QList>
00034 
00035 class KFileItemPrivate;
00036 
00045 class KIO_EXPORT KFileItem
00046 {
00047 public:
00048     enum { Unknown = (mode_t) - 1 };
00049 
00056     enum FileTimes {
00057         // warning: don't change without looking at the Private class
00058         ModificationTime = 0,
00059         AccessTime = 1,
00060         CreationTime = 2
00061         //ChangeTime
00062     };
00063 
00070     KFileItem();
00071 
00087     KFileItem( const KIO::UDSEntry& entry, const KUrl& itemOrDirUrl,
00088                bool delayedMimeTypes = false,
00089                bool urlIsDirectory = false );
00090 
00104     KFileItem( mode_t mode, mode_t permissions, const KUrl& url,
00105                bool delayedMimeTypes = false );
00106 
00113     KFileItem( const KUrl &url, const QString &mimeType, mode_t mode );
00114 
00118     KFileItem(const KFileItem& other);
00122     KFileItem& operator=(const KFileItem& other);
00123 
00128     ~KFileItem();
00129 
00134     void refresh();
00135 
00140     void refreshMimeType();
00141 
00146     KUrl url() const;
00147 
00153     void setUrl( const KUrl &url );
00154 
00161     void setName( const QString &name );
00162 
00167     mode_t permissions() const;
00168 
00173     QString permissionsString() const;
00174 
00179     bool hasExtendedACL() const;
00180 
00185     KACL ACL() const;
00186 
00191     KACL defaultACL() const;
00192 
00197     mode_t mode() const;
00198 
00203     QString user() const;
00204 
00209     QString group() const;
00210 
00216     bool isLink() const;
00217 
00222     bool isDir() const;
00223 
00228     bool isFile() const;
00229 
00236     bool isReadable() const;
00237 
00244     bool isWritable() const;
00245 
00250     bool isHidden() const;
00251 
00258     bool isDesktopFile() const;
00259 
00264     QString linkDest() const;
00265 
00272     KUrl targetUrl() const;
00273 
00279     QString localPath() const;
00280 
00285     KIO::filesize_t size() const;
00286 
00293     KDateTime time( FileTimes which ) const;
00294     KDE_DEPRECATED time_t time( unsigned int which ) const;
00295 
00303     QString timeString( FileTimes which = ModificationTime ) const;
00304     KDE_DEPRECATED QString timeString( unsigned int which) const;
00305 
00310     bool isLocalFile() const;
00311 
00317     QString text() const;
00318 
00326     QString name( bool lowerCase = false ) const;
00327 
00334     QString mimetype() const;
00335 
00342     KMimeType::Ptr determineMimeType() const;
00343 
00349     KMimeType::Ptr mimeTypePtr() const;
00350 
00357     bool isMimeTypeKnown() const;
00358 
00364     QString mimeComment() const;
00365 
00371     QString iconName() const;
00372 
00381     QPixmap pixmap( int _size, int _state=0 ) const;
00382 
00389     QStringList overlays() const;
00390 
00396     QString getStatusBarInfo() const;
00397 
00406     QString getToolTipText(int maxcount = 6) const;
00407 
00418     KDE_DEPRECATED bool acceptsDrops() const;
00419 
00424     void run( QWidget* parentWidget = 0 ) const;
00425 
00431     KIO::UDSEntry entry() const;
00432 
00437     bool isMarked() const;
00442     void mark();
00447     void unmark();
00448 
00457     bool cmp( const KFileItem & item ) const;
00458 
00459     bool operator==(const KFileItem& other) const;
00460 
00461     bool operator!=(const KFileItem& other) const;
00462 
00463 
00468     operator QVariant() const;
00469 
00505     KDE_DEPRECATED void setExtraData( const void *key, void *value );
00506 
00516     KDE_DEPRECATED const void * extraData( const void *key ) const;
00517 
00524     KDE_DEPRECATED void removeExtraData( const void *key );
00525 
00532     void setMetaInfo( const KFileMetaInfo & info ) const;
00533 
00539     KFileMetaInfo metaInfo(bool autoget = true,
00540                                    int what = KFileMetaInfo::Fastest) const;
00541 
00545     KDE_DEPRECATED void assign( const KFileItem & item );
00546 
00566     KDE_DEPRECATED void setUDSEntry( const KIO::UDSEntry& entry, const KUrl& url,
00567                                      bool delayedMimeTypes = false,
00568                                      bool urlIsDirectory = false );
00569 
00574     KUrl mostLocalUrl(bool &local) const; // KDE4 TODO: bool* local = 0
00575 
00579     bool isNull() const;
00580 
00581 private:
00582     QSharedDataPointer<KFileItemPrivate> d;
00583 
00584 private:
00585     KIO_EXPORT friend QDataStream & operator<< ( QDataStream & s, const KFileItem & a );
00586     KIO_EXPORT friend QDataStream & operator>> ( QDataStream & s, KFileItem & a );
00587 };
00588 
00589 Q_DECLARE_METATYPE(KFileItem)
00590 
00591 Q_CORE_EXPORT uint qHash(const QString &key);
00592 inline uint qHash(const KFileItem& item){ return qHash(item.url().url()); }
00593 
00598 class KIO_EXPORT KFileItemList : public QList<KFileItem>
00599 {
00600 public:
00602   KFileItemList();
00603 
00605   KFileItemList( const QList<KFileItem> &items );
00606 
00612   KFileItem findByName( const QString& fileName ) const;
00613 
00619   KFileItem findByUrl( const KUrl& url ) const;
00620 
00622   KUrl::List urlList() const;
00623 
00626   KUrl::List targetUrlList() const;
00627 };
00628 
00629 KIO_EXPORT QDataStream & operator<< ( QDataStream & s, const KFileItem & a );
00630 KIO_EXPORT QDataStream & operator>> ( QDataStream & s, KFileItem & a );
00631 
00632 
00633 #endif

KIO

Skip menu "KIO"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • kio
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Plasma
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.7
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal