<commit_before>#ifndef __GNOME_PIXMAP_H__
#define __GNOME_PIXMAP_H__


#include <libgnome/gnome-defs.h>
#include <gtk/gtkwidget.h>
#include <gtk/gtkpixmap.h>
#include <gtk/gtkvbox.h>
#include <gtk/gtkbutton.h>


/* A short description:

   These functions provide an applications programmer with default
   icons for toolbars, menu pixmaps, etc. One such `icon' should have
   at least three pixmaps to reflect it's state. There is a `regular'
   pixmap, a `disabled' pixmap and a `focused' pixmap. You can get
   either each of these pixmaps by calling gnome_stock_pixmap or you
   can get a widget by calling gnome_stock_pixmap_widget. This widget
   is a container which gtk_widget_shows the pixmap, that is
   reflecting the current state of the widget. If for example you
   gtk_container_add this widget to a button, which is currently not
   sensitive, the widget will just show the `disabled' pixmap. If the
   state of the button changes to sensitive, the widget will change to
   the `regular' pixmap. The `focused' pixmap will be shown, when the
   mouse pointer enters the widget.

   To support themability, we use (char *) to call those functions. A
   new theme might register new icons by calling
   gnome_stock_pixmap_register, or may change existing icons by
   calling gnome_stock_pixmap_change. An application should check (by
   calling gnome_stock_pixmap_checkfor), if the current theme supports
   an uncommon icon, before using it. The only icons an app can rely
   on, are those defined in this haeder file. */

/* State:

   currently implemented:
     - gnome_stock_pixmap
     - gnome_stock_pixmap_widget
     - gnome_stock_pixmap_checkfor

   not fully implemented:
     - GnomeStockPixmapWidget (usable, but doesn't change the pixmap)

   not implemented:
     - gnome_stock_pixmap_register
     - gnome_stock_pixmap_change
 */

BEGIN_GNOME_DECLS

/* The names of `well known' icons. I define these strings basically
   to prevent errors due to typos. */

#define GNOME_STOCK_PIXMAP_NEW         "New"
#define GNOME_STOCK_PIXMAP_OPEN        "Open"
#define GNOME_STOCK_PIXMAP_SAVE        "Save"
#define GNOME_STOCK_PIXMAP_CUT         "Cut"
#define GNOME_STOCK_PIXMAP_COPY        "Copy"<commit_msg>updated the state and description comments <NAME><commit_after>#ifndef __GNOME_PIXMAP_H__
#define __GNOME_PIXMAP_H__


#include <libgnome/gnome-defs.h>
#include <gtk/gtkwidget.h>
#include <gtk/gtkpixmap.h>
#include <gtk/gtkvbox.h>
#include <gtk/gtkbutton.h>


/* A short description:

   These functions provide an applications programmer with default
   icons for toolbars, menu pixmaps, etc. One such `icon' should have
   at least three pixmaps to reflect it's state. There is a `regular'
   pixmap, a `disabled' pixmap and a `focused' pixmap. You can get
   either each of these pixmaps by calling gnome_stock_pixmap or you
   can get a widget by calling gnome_stock_pixmap_widget. This widget
   is a container which gtk_widget_shows the pixmap, that is
   reflecting the current state of the widget. If for example you
   gtk_container_add this widget to a button, which is currently not
   sensitive, the widget will just show the `disabled' pixmap. If the
   state of the button changes to sensitive, the widget will change to
   the `regular' pixmap. The `focused' pixmap will be shown, when the
   mouse pointer enters the widget.

   To support themability, we use (char *) to call those functions. A
   new theme might register new icons by calling
   gnome_stock_pixmap_register, or may change existing icons by
   calling gnome_stock_pixmap_change. An application should check (by
   calling gnome_stock_pixmap_checkfor), if the current theme supports
   an uncommon icon, before using it. The only icons an app can rely
   on, are those defined in this haeder file.

   We now have stock buttons too. To use them, just replace any
   gtk_button_new{_with_label} with
   gnome_stock_button(GNOME_STOCK_BUTTON_...).  This function returns
   a GtkButton with a gettexted default text and an icon. */

/* State:

   currently implemented:
     - gnome_stock_pixmap
     - gnome_stock_pixmap_widget
     - gnome_stock_pixmap_checkfor
     - GnomeStockPixmapWidget
     - gnome_stock_button

   not implemented:
     - gnome_stock_pixmap_register
     - gnome_stock_pixmap_change
 */

BEGIN_GNOME_DECLS

/* The names of `well known' icons. I define these strings basically
   to prevent errors due to typos. */

#define GNOME_STOCK_PIXMAP_NEW         "New"
#define GNOME_STOCK_PIXMAP_OPEN        "Open"
#define GNOME_STOCK_PIXMAP_SAVE        "Save"
#define GNOME_STOCK_PIXMAP_CUT         "Cut"
#define GNOME_STOCK_PIXMAP_COPY        "Copy"
{'fraction_non_alphanumeric': 0.05412922550278134, 'fraction_numerical': 0.0, 'mean_word_length': 3.7899590163934427, 'pattern_counts': {'":': 0, '<': 14, '<?xml version=': 0, '>': 14, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4193393', 'n_tokens_mistral': 1537, 'n_tokens_neox': 1394, 'n_words': 547}