Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 129 insertions, 0 deletions

diff --git a/kio/kfile/kfile.h b/kio/kfile/kfile.h
new file mode 100644
index 000000000..70253f9d8
--- /dev/null
+++ b/kio/kfile/kfile.h
@@ -0,0 +1,129 @@
+/* This file is part of the KDE libraries
+    Copyright (C) 2000 Carsten Pfeiffer <pfeiffer@kde.org>
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Library General Public
+    version 2, License as published by the Free Software Foundation.
+
+    This library is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+    Library General Public License for more details.
+
+    You should have received a copy of the GNU Library General Public License
+    along with this library; see the file COPYING.LIB.  If not, write to
+    the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+    Boston, MA 02110-1301, USA.
+*/
+#ifndef KFILE_H
+#define KFILE_H
+
+#include <qdir.h>
+
+#include "kdelibs_export.h"
+
+/**
+ * KFile is a class which provides a namespace for some enumerated
+ * values associated with the kfile library.  You will never need to
+ * construct a KFile object itself.
+ */
+
+class KIO_EXPORT KFile
+{
+public:
+    /**
+     * Modes of operation for the dialog.
+     * @li @p File - Get a single file name from the user.
+     * @li @p Directory - Get a directory name from the user.
+     * @li @p Files - Get multiple file names from the user.
+     * @li @p ExistingOnly - Never return a filename which does not exist yet
+     * @li @p LocalOnly - Don't return remote filenames
+     */
+    enum Mode {
+	File         = 1,
+	Directory    = 2,
+	Files        = 4,
+	ExistingOnly = 8,
+	LocalOnly    = 16,
+        ModeMax      = 65536
+    };
+
+    enum FileView {
+	Default         = 0,
+	Simple          = 1,
+	Detail          = 2,
+	SeparateDirs    = 4,
+	PreviewContents = 8,
+	PreviewInfo     = 16,
+        FileViewMax     = 65536
+    };
+
+    enum SelectionMode {
+	Single      = 1,
+	Multi       = 2,
+	Extended    = 4,
+	NoSelection = 8
+    };
+
+
+    //
+    // some bittests
+    //
+
+
+    // sorting specific
+
+    // grr, who had the idea to set QDir::Name to 0x0?
+    static bool isSortByName( const QDir::SortSpec& sort ) {
+	return (sort & QDir::Time) != QDir::Time &&
+	       (sort & QDir::Size) != QDir::Size;
+    }
+
+    static bool isSortBySize( const QDir::SortSpec& sort ) {
+	return (sort & QDir::Size) == QDir::Size;
+    }
+
+    static bool isSortByDate( const QDir::SortSpec& sort ) {
+	return (sort & QDir::Time) == QDir::Time;
+    }
+
+    static bool isSortDirsFirst( const QDir::SortSpec& sort ) {
+	return (sort & QDir::DirsFirst) == QDir::DirsFirst;
+    }
+
+    static bool isSortCaseInsensitive( const QDir::SortSpec& sort ) {
+	return (sort & QDir::IgnoreCase) == QDir::IgnoreCase;
+    }
+
+
+    // view specific
+    static bool isDefaultView( const FileView& view ) {
+	return (view & Default) == Default;
+    }
+
+    static bool isSimpleView( const FileView& view ) {
+	return (view & Simple) == Simple;
+    }
+
+    static bool isDetailView( const FileView& view ) {
+	return (view & Detail) == Detail;
+    }
+
+    static bool isSeparateDirs( const FileView& view ) {
+	return (view & SeparateDirs) == SeparateDirs;
+    }
+
+    static bool isPreviewContents( const FileView& view ) {
+	return (view & PreviewContents) == PreviewContents;
+    }
+
+    /**
+     * @since 3.1
+     */
+    static bool isPreviewInfo( const FileView& view ) {
+        return (view & PreviewInfo) == PreviewInfo;
+    }
+
+};
+
+#endif // KFILE_H