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 Computer, 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 "PlatformString.h"
  34 #include <wtf/Vector.h>
  35
  36 namespace WebCore {
  37
  38 class Font;
  39 class Icon;
  40
  41 class FileChooserClient {
  42 public:
  43     virtual void valueChanged() = 0;
  44     virtual bool allowsMultipleFiles() = 0;
  45     virtual String acceptTypes() = 0;
  46     virtual ~FileChooserClient();
  47 };
  48
  49 class FileChooser : public RefCounted<FileChooser> {
  50 public:
  51     static PassRefPtr<FileChooser> create(FileChooserClient*, const Vector<String>& initialFilenames);
  52     ~FileChooser();
  53
  54     void disconnectClient() { m_client = 0; }
  55     bool disconnected() { return !m_client; }
  56
  57     const Vector<String>& filenames() const { return m_filenames; }
  58     String basenameForWidth(const Font&, int width) const;
  59
  60     Icon* icon() const { return m_icon.get(); }
  61
  62     void clear(); // for use by client; does not call valueChanged
  63
  64     void chooseFile(const String& path);
  65     void chooseFiles(const Vector<String>& paths);
  66
  67     bool allowsMultipleFiles() const { return m_client ? m_client->allowsMultipleFiles() : false; }
  68     // Acceptable MIME types.  It's an 'accept' attribute value of the corresponding INPUT element.
  69     String acceptTypes() const { return m_client ? m_client->acceptTypes() : String(); }
  70
  71 private:
  72     FileChooser(FileChooserClient*, const Vector<String>& initialFilenames);
  73
  74     FileChooserClient* m_client;
  75     Vector<String> m_filenames;
  76     RefPtr<Icon> m_icon;
  77 };
  78
  79 } // namespace WebCore
  80
  81 #endif // FileChooser_h