mime-application.h

Go to the documentation of this file.

// -*- c++ -*-
// Generated by gtkmmproc -- DO NOT MODIFY!
#ifndef _LIBGNOMEVFSMM_MIME_APPLICATION_H
#define _LIBGNOMEVFSMM_MIME_APPLICATION_H
 
 
#include <glibmm.h>
 
/* Copyright 2003 gnome-vfsmm Development Team
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 *
 * 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
 
#include <libgnomevfs/gnome-vfs-mime-handlers.h>
#include <libgnomevfs/gnome-vfs-application-registry.h>
 
#include <libgnomevfsmm/enums.h>
#include <libgnomevfsmm/exception.h>
 
 
namespace Gnome
{
 
namespace Vfs
{
 
typedef Glib::ListHandle<Glib::ustring> ListHandleStrings;
 
//TODO: What is a MimeApplication? How can I get one. What could I do with one.
class MimeApplication
{
  public:
#ifndef DOXYGEN_SHOULD_SKIP_THIS
  typedef MimeApplication CppObjectType;
  typedef GnomeVFSMimeApplication BaseObjectType;
#endif /* DOXYGEN_SHOULD_SKIP_THIS */
 
  MimeApplication();
 
  // Use make_a_copy=true when getting it directly from a struct.
  explicit MimeApplication(GnomeVFSMimeApplication* castitem, bool make_a_copy = false);
 
  MimeApplication(const MimeApplication& src);
  MimeApplication& operator=(const MimeApplication& src);
 
  ~MimeApplication();
 
  GnomeVFSMimeApplication*       gobj()       { return gobject_; }
  const GnomeVFSMimeApplication* gobj() const { return gobject_; }
 
  GnomeVFSMimeApplication* gobj_copy() const;
 
protected:
  GnomeVFSMimeApplication* gobject_;
 
private:
 
 
public:
  MimeApplication(const Glib::ustring& id);
 
  MimeApplication(const Glib::ustring& id, const Glib::ustring& name,
      const Glib::ustring& command, MimeApplicationArgumentType argument_type, 
      ListHandleStrings supported_uri_schemes, bool multiple_files, bool requires_terminal);
 
  //Test whether this is a valid instance.
  operator bool() const;
 
   Glib::ustring get_id() const;
   
   Glib::ustring get_name() const;
   
   Glib::ustring get_command() const;
   
   MimeApplicationArgumentType get_argument_type() const;
   
   Glib::ListHandle<Glib::ustring> get_supported_uri_schemes() const;
   
  bool can_open_multiple_files() const;
  
  bool requires_terminal() const;
 
  //TODO: These don't seem to use g_strdup(), but they should.
   void set_id(const Glib::ustring& value);
    void set_name(const Glib::ustring& value);
    void set_command(const Glib::ustring& value);
    void set_argument_type(const MimeApplicationArgumentType& value);
    void set_supported_uri_schemes(const Glib::ListHandle<Glib::ustring>& value);
 
  void set_open_multiple_files(bool value = true);
  void set_requires_terminal(bool value = true);
 
  /*
   * Application Registry convenience functions
   */
  
  bool is_user_owned() const;
  
  bool exists_in_registry() const;
  void remove_from_registry();
  
  void save_to_registry();
  
  ListHandleStrings get_keys() const;
  
  ListHandleStrings get_mime_types() const;
  void clear_mime_types();
 
  bool supports_mime_type(const Glib::ustring& mime_type) const;
  bool supports_uri_scheme(const Glib::ustring& uri_scheme) const;
  
  Glib::ustring get_value(const Glib::ustring& key) const;
  bool get_value_bool(const Glib::ustring& key, bool& got_key) const;
  bool get_value_bool(const Glib::ustring& key) const;
  
  void set_value(const Glib::ustring& key, const Glib::ustring& value);
  void set_value(const Glib::ustring& key, bool value);
  void unset_key(const Glib::ustring& key);
  
  void add_mime_type(const Glib::ustring& mime_type);
  void remove_mime_type(const Glib::ustring& mime_type);
 
  /*
   * Mime Database convenience functions
   */
 
  #ifdef GLIBMM_EXCEPTIONS_ENABLED
 
  void set_default(const Glib::ustring& mime_type) throw(exception);
  void add_to_short_list(const Glib::ustring& mime_type) throw(exception);
  void remove_from_short_list(const Glib::ustring& mime_type) throw(exception);
 
  void launch(const Glib::ListHandle<Glib::ustring>& uris) throw(exception);
  void launch(const Glib::ListHandle<Glib::ustring>& uris, const Glib::ustring& envp) throw(exception);
 
  #else
 
  void set_default(const Glib::ustring& mime_type, std::auto_ptr<Gnome::Vfs::exception>& error);
  void add_to_short_list(const Glib::ustring& mime_type, std::auto_ptr<Gnome::Vfs::exception>& error);
  void remove_from_short_list(const Glib::ustring& mime_type, std::auto_ptr<Gnome::Vfs::exception>& error);
 
  void launch(const Glib::ListHandle<Glib::ustring>& uris, std::auto_ptr<Gnome::Vfs::exception>& error);
  void launch(const Glib::ListHandle<Glib::ustring>& uris, const Glib::ustring& envp, std::auto_ptr<Gnome::Vfs::exception>& error);
 
  #endif
 
 
};
 
} // namespace Vfs
} // namespace Gnome
 
 
namespace Glib
{
 
Gnome::Vfs::MimeApplication wrap(GnomeVFSMimeApplication* object, bool take_copy = false);
 
} // namespace Glib
 
 
#endif /* _LIBGNOMEVFSMM_MIME_APPLICATION_H */