libs/gtkutil/filechooser.h

   1 /*
   2 Copyright (C) 2001-2006, William Joseph.
   3 All Rights Reserved.
   4
   5 This file is part of GtkRadiant.
   6
   7 GtkRadiant is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 GtkRadiant is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with GtkRadiant; if not, write to the Free Software
  19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  20 */
  21
  22 #if !defined(INCLUDED_GTKUTIL_FILECHOOSER_H)
  23 #define INCLUDED_GTKUTIL_FILECHOOSER_H
  24
  25 /// \file
  26 /// GTK+ file-chooser dialogs.
  27
  28 typedef struct _GtkWidget GtkWidget;
  29 const char* file_dialog(GtkWidget *parent, bool open, const char* title, const char* path = 0, const char* pattern = 0);
  30
  31
  32 /// \brief Prompts the user to browse for a directory.
  33 /// The prompt window will be transient to \p parent.
  34 /// The directory will initially default to \p path, which must be an absolute path.
  35 /// The returned string is allocated with \c g_malloc and must be freed with \c g_free.
  36 char* dir_dialog(GtkWidget *parent, const char* title = "Choose Directory", const char* path = "");
  37
  38 #endif