qulogic/libgnt

wms/s: Special case "MainWindow" instead of "buddylist" window

2018-12-19, Mike Ruprecht
a38f3048639b
wms/s: Special case "MainWindow" instead of "buddylist" window

This patch changes the sample window manager from demonstrating
specially handling a window named "buddylist" to handling one named
"MainWindow" instead. This is an additional change in order to make
the sample window manager more generic and less bound to its
libpurple roots. The keyboard shortcut was kept as Alt+B as I
couldn't find a more appropriate alternative which wasn't already
used.
/*
* GNT - The GLib Ncurses Toolkit
*
* GNT is the legal property of its developers, whose names are too numerous
* to list here. Please refer to the COPYRIGHT file distributed with this
* source distribution.
*
* This library 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.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License along with
* this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#ifndef GNT_STYLE_H
#define GNT_STYLE_H
/**
* SECTION:gntstyle
* @section_id: libgnt-gntstyle
* @short_description: <filename>gntstyle.h</filename>
* @title: Style API
*/
#include "gnt.h"
#include "gntwm.h"
typedef enum
{
GNT_STYLE_SHADOW = 0,
GNT_STYLE_COLOR = 1,
GNT_STYLE_MOUSE = 2,
GNT_STYLE_WM = 3,
GNT_STYLE_REMPOS = 4,
GNT_STYLES
} GntStyle;
/**
* gnt_style_read_configure_file:
* @filename: The filename to read configuration from.
*
* Read configuration from a file.
*/
void gnt_style_read_configure_file(const char *filename);
/**
* gnt_style_get:
* @style: The style.
*
* Get the user-setting for a style.
*
* Returns: The user-setting, or %NULL.
*/
const char *gnt_style_get(GntStyle style);
/**
* gnt_style_get_from_name:
* @group: The name of the group in the keyfile. If %NULL, the prgname
* will be used first, if available. Otherwise, "general" will be used.
* @key: The key
*
* Get the value of a preference in ~/.gntrc.
*
* Returns: The value of the setting as a string, or %NULL
*
* Since: 2.0.0
*/
char *gnt_style_get_from_name(const char *group, const char *key);
/**
* gnt_style_get_string_list:
* @group: The name of the group in the keyfile. If %NULL, the prgname
* will be used first, if available. Otherwise, "general" will be used.
* @key: The key
* @length: Return location for the number of strings returned, or NULL
*
* Get the value of a preference in ~/.gntrc.
*
* Returns: (transfer full): %NULL terminated string array. The array should be
* freed with g_strfreev().
*
* Since: 2.4.0
*/
char **gnt_style_get_string_list(const char *group, const char *key, gsize *length);
/**
* gnt_style_get_color:
* @group: The name of the group in the keyfile. If %NULL, the prgname
* will be used first, if available. Otherwise, "general" will be used.
* @key: The key
*
* Get the value of a color pair in ~/.gntrc.
*
* Returns: The value of the color as an int, or 0 on error.
*
* Since: 2.4.0
*/
int gnt_style_get_color(char *group, char *key);
/**
* gnt_style_parse_bool:
* @value: The value of the boolean setting as a string
*
* Parse a boolean preference. For example, if 'value' is "false" (ignoring case)
* or "0", the return value will be %FALSE, otherwise %TRUE.
*
* Returns: The boolean value
*
* Since: 2.0.0
*/
gboolean gnt_style_parse_bool(const char *value);
/**
* gnt_style_get_bool:
* @style: The style.
* @def: The default value (i.e, the value if the user didn't define
* any value)
*
* Get the boolean value for a user-setting.
*
* Returns: The value of the setting.
*/
gboolean gnt_style_get_bool(GntStyle style, gboolean def);
/**
* gnt_styles_get_keyremaps:
*
* Internal function -- do not use.
*/
void gnt_styles_get_keyremaps(GType type, GHashTable *hash);
/**
* gnt_style_read_actions:
*
* Internal function -- do not use.
*/
void gnt_style_read_actions(GType type, GntBindableClass *klass);
/**
* gnt_style_read_menu_accels:
* @name: The name of the window.
* @table: The hastable to store the accel information.
*
* Read menu-accels from ~/.gntrc
*
* Returns: %TRUE if some accels were read, %FALSE otherwise.
*/
gboolean gnt_style_read_menu_accels(const char *name, GHashTable *table);
/**
* gnt_style_read_workspaces:
*
* Reads workspace information.
*
* Internal function -- do not use.
*/
void gnt_style_read_workspaces(GntWM *wm);
/**
* gnt_init_styles:
*
* Initialize style settings.
*/
void gnt_init_styles(void);
/**
* gnt_uninit_styles:
*
* Uninitialize style settings.
*/
void gnt_uninit_styles(void);
#endif /* GNT_STYLE_H */