summaryrefslogtreecommitdiff
path: root/libopie2/opieui/fileselector/ofiledialog.h
blob: 01a599bee9fa2d0591209b9a753e79b124948af3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
/*
               =.            This file is part of the OPIE Project
             .=l.            Copyright (c)  2002 zecke <zecke@handhelds.org>
           .>+-=
 _;:,     .>    :=|.         This library is free software; you can
.> <`_,   >  .   <=          redistribute it and/or  modify it under
:`=1 )Y*s>-.--   :           the terms of the GNU Library General Public
.="- .-=="i,     .._         License as published by the Free Software
 - .   .-<_>     .<>         Foundation; either version 2 of the License,
     ._= =}       :          or (at your option) any later version.
    .%`+i>       _;_.
    .i_,=:_.      -<s.       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., 59 Temple Place - Suite 330,
                             Boston, MA 02111-1307, USA.

*/

#ifndef OFILEDIALOG_H
#define OFILEDIALOG_H

/* OPIE */
#include <opie2/ofileselector.h>

/* QT */
#include <qdialog.h>

namespace Opie
{

/**
 * This class places a OFileSelector inside a QDialog.
 * It provides static method for letting a user chose
 * a file for either opening or saving.
 * Most of the time  the c'tor will not be used instead using
 * the static member functions is prefered.
 *
 * <pre>
 * QMap<QString, QStringList> mimeTypes;
 * QStringList types;
 * types << "text[slash]* ";
 * mimeTypes.insert( tr("Text"), types );
 * mimeTypes.insert( tr("All"), " * / * " ); // remove the spaces in the 2nd comment
 * QString fileName= OFileDialog::getOpenFileName( OFileSelector::EXTENDED_ALL,
 *                                                 "foo","bar", mimeTypes);
 * </pre>
 *
 * @short A small QDialog swalloing a FileSelector
 * @see QDialog
 * @see OFileSelector
 * @version 0.1-unfinished
 * @author Holger Freyther ( zecke@handhelds.org )
 */
class OFileDialog : public QDialog
{
    Q_OBJECT
public:
    OFileDialog(const QString &caption,
                QWidget *, int mode, int selector,
                const QString &dirName,
                const QString &fileName = QString::null,
                const MimeTypes &mimetypes = MimeTypes()  );
    QString mimetype() const;
    QString fileName() const;
    DocLnk selectedDocument()const;

    // static methods
    static QString getOpenFileName(int selector,
                                   const QString& startDir = QString::null,
                                   const QString &fileName = QString::null,
                                   const MimeTypes& mime = MimeTypes(),
                                   QWidget *wid = 0,
                                   const QString &caption = QString::null );

    static QString getSaveFileName(int selector,
                                   const QString& startDir = QString::null,
                                   const QString& fileName = QString::null,
                                   const MimeTypes& mimefilter = MimeTypes(),
                                   QWidget *wid = 0,
                                   const QString &caption = QString::null );

    //let's OFileSelector catch up first
    //static QString getExistingDirectory(const QString& startDir = QString::null,
    //QWidget *parent = 0, const QString& caption = QString::null );
    
private:
    class OFileDialogPrivate;
    OFileDialogPrivate *d;
    OFileSelector *file;

private slots:
    void slotFileSelected( const QString & );
    void slotDirSelected(const QString & );
    void slotSelectorOk();
};

};

#endif