medit/moo/mooutils/mooutils-misc.h

/*
 *   mooutils-misc.h
 *
 *   Copyright (C) 2004-2006 by Yevgen Muntyan <muntyan@math.tamu.edu>
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   See COPYING file that comes with this distribution.
 */

#ifndef __MOO_UTILS_MISC_H__
#define __MOO_UTILS_MISC_H__

#include <gtk/gtk.h>

G_BEGIN_DECLS


gboolean    moo_open_url                    (const char *url);
gboolean    moo_open_email                  (const char *address,
                                             const char *subject,
                                             const char *body);


gboolean    moo_window_is_hidden            (GtkWindow  *window);
void        moo_window_present              (GtkWindow  *window);
GtkWindow  *moo_get_top_window              (GSList     *windows);
GtkWindow  *moo_get_toplevel_window         (void);

gboolean    moo_window_set_icon_from_stock  (GtkWindow  *window,
                                             const char *stock_id);


void        moo_log_window_show             (void);
void        moo_log_window_hide             (void);

/* these two are wrappers for g_print, needed for python stdout/stderr */
void        moo_print                       (const char     *string);
void        moo_print_err                   (const char     *string);

void        moo_set_log_func_window         (gboolean        show_now);
void        moo_set_log_func_file           (const char     *log_file);
void        moo_set_log_func_silent         (void);
void        moo_reset_log_func              (void);


void        moo_segfault                    (void);
gboolean    moo_debug_enabled               (void) G_GNUC_CONST;


#define MOO_TYPE_DATA_DIR_TYPE              (moo_data_dir_type_get_type ())

typedef enum {
    MOO_DATA_SHARE,
    MOO_DATA_LIB
} MooDataDirType;

GType       moo_data_dir_type_get_type      (void) G_GNUC_CONST;

/* application directory on win32 */
char       *moo_get_app_dir                 (void);

/* ~/.appname */
gboolean    moo_make_user_data_dir          (void);
char       *moo_get_user_data_dir           (void);
char       *moo_get_user_data_file          (const char     *basename);
gboolean    moo_save_user_data_file         (const char     *basename,
                                             const char     *content,
                                             gssize          len,
                                             GError        **error);

/* user data comes last; MOO_DATA_DIR comes first */
/* $MOO_APP_DIR:$MOO_DATA_DIRS:$prefix/share/appname or
   $MOO_APP_DIR:$MOO_LIB_DIRS:$prefix/lib/appname */
char      **moo_get_data_dirs               (MooDataDirType  type,
                                             guint          *n_dirs);
char      **moo_get_data_subdirs            (const char     *subdir,
                                             MooDataDirType  type,
                                             guint          *n_dirs);
#define moo_get_data_files moo_get_data_subdirs


void        moo_selection_data_set_pointer  (GtkSelectionData *data,
                                             GdkAtom         type,
                                             gpointer        ptr);
gpointer    moo_selection_data_get_pointer  (GtkSelectionData *data,
                                             GdkAtom         type);

GdkModifierType moo_get_modifiers           (GtkWidget      *widget);

void        moo_menu_item_set_accel_label   (GtkWidget      *menu_item,
                                             const char     *label);
void        moo_menu_item_set_label         (GtkWidget      *menu_item,
                                             const char     *label,
                                             gboolean        mnemonic);

void        moo_widget_set_tooltip          (GtkWidget      *widget,
                                             const char     *tip);

char      **moo_splitlines                  (const char     *string);


G_END_DECLS

#endif /* __MOO_UTILS_MISC_H__ */