Update ANGLE
[WebKit-https.git] / Source / WebCore / platform / FileChooser.h
1 /*
2  * Copyright (C) 2006, 2007, 2008 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1.  Redistributions of source code must retain the above copyright
9  *     notice, this list of conditions and the following disclaimer. 
10  * 2.  Redistributions in binary form must reproduce the above copyright
11  *     notice, this list of conditions and the following disclaimer in the
12  *     documentation and/or other materials provided with the distribution. 
13  * 3.  Neither the name of Apple Inc. ("Apple") nor the names of
14  *     its contributors may be used to endorse or promote products derived
15  *     from this software without specific prior written permission. 
16  *
17  * THIS SOFTWARE IS PROVIDED BY APPLE AND ITS CONTRIBUTORS "AS IS" AND ANY
18  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
19  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20  * DISCLAIMED. IN NO EVENT SHALL APPLE OR ITS CONTRIBUTORS BE LIABLE FOR ANY
21  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
24  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  *
28  */
29
30 #ifndef FileChooser_h
31 #define FileChooser_h
32
33 #include <wtf/RefCounted.h>
34 #include <wtf/Vector.h>
35 #include <wtf/text/WTFString.h>
36
37 namespace WebCore {
38
39 enum MediaCaptureType {
40     MediaCaptureTypeNone,
41     MediaCaptureTypeUser,
42     MediaCaptureTypeEnvironment
43 };
44     
45 class FileChooser;
46 class Icon;
47
48 struct FileChooserFileInfo {
49     FileChooserFileInfo(const String& path, const String& displayName = String())
50         : path(path)
51         , displayName(displayName)
52     {
53     }
54
55     const String path;
56     const String displayName;
57 };
58
59 struct FileChooserSettings {
60     bool allowsMultipleFiles;
61     Vector<String> acceptMIMETypes;
62     Vector<String> acceptFileExtensions;
63     Vector<String> selectedFiles;
64 #if ENABLE(MEDIA_CAPTURE)
65     MediaCaptureType mediaCaptureType;
66 #endif
67
68     // Returns a combined vector of acceptMIMETypes and acceptFileExtensions.
69     Vector<String> acceptTypes() const;
70 };
71
72 class FileChooserClient {
73 public:
74     virtual ~FileChooserClient() { }
75
76     virtual void filesChosen(const Vector<FileChooserFileInfo>&) = 0;
77 #if PLATFORM(IOS)
78     // FIXME: This function is almost identical to FileChooser::filesChosen(). We should merge this
79     // function with FileChooser::filesChosen() and hence remove the PLATFORM(IOS)-guard.
80     virtual void filesChosen(const Vector<FileChooserFileInfo>&, const String& displayString, Icon*) = 0;
81 #endif
82 };
83
84 class FileChooser : public RefCounted<FileChooser> {
85 public:
86     static Ref<FileChooser> create(FileChooserClient*, const FileChooserSettings&);
87     WEBCORE_EXPORT ~FileChooser();
88
89     void invalidate();
90
91     WEBCORE_EXPORT void chooseFile(const String& path);
92     WEBCORE_EXPORT void chooseFiles(const Vector<String>& paths);
93 #if PLATFORM(IOS)
94     // FIXME: This function is almost identical to FileChooser::chooseFiles(). We should merge this
95     // function with FileChooser::chooseFiles() and hence remove the PLATFORM(IOS)-guard.
96     WEBCORE_EXPORT void chooseMediaFiles(const Vector<String>& paths, const String& displayString, Icon*);
97 #endif    
98
99     // FIXME: We should probably just pass file paths that could be virtual paths with proper display names rather than passing structs.
100     void chooseFiles(const Vector<FileChooserFileInfo>& files);
101
102     const FileChooserSettings& settings() const { return m_settings; }
103
104 private:
105     FileChooser(FileChooserClient*, const FileChooserSettings&);
106
107     FileChooserClient* m_client;
108     FileChooserSettings m_settings;
109 };
110
111 } // namespace WebCore
112
113 #endif // FileChooser_h