/* GTK - The GIMP Toolkit * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald * * Copyright (C) 2004-2006 Christian Hammond * Copyright (C) 2008 Cody Russell * Copyright (C) 2008 Red Hat, Inc. * * 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 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, see . */ /* * Modified by the GTK+ Team and others 1997-2000. See the AUTHORS * file for a list of people on the GTK+ Team. See the ChangeLog * files for a list of changes. These files are distributed with * GTK+ at ftp://ftp.gtk.org/pub/gtk/. */ #ifndef __GTK_ENTRY_H__ #define __GTK_ENTRY_H__ #if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) #error "Only can be included directly." #endif #include #include #include #include #include #include #include G_BEGIN_DECLS #define GTK_TYPE_ENTRY (gtk_entry_get_type ()) #define GTK_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_ENTRY, GtkEntry)) #define GTK_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_ENTRY, GtkEntryClass)) #define GTK_IS_ENTRY(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_ENTRY)) #define GTK_IS_ENTRY_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_ENTRY)) #define GTK_ENTRY_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_ENTRY, GtkEntryClass)) /** * GtkEntryIconPosition: * @GTK_ENTRY_ICON_PRIMARY: At the beginning of the entry (depending on the text direction). * @GTK_ENTRY_ICON_SECONDARY: At the end of the entry (depending on the text direction). * * Specifies the side of the entry at which an icon is placed. */ typedef enum { GTK_ENTRY_ICON_PRIMARY, GTK_ENTRY_ICON_SECONDARY } GtkEntryIconPosition; typedef struct _GtkEntry GtkEntry; typedef struct _GtkEntryPrivate GtkEntryPrivate; typedef struct _GtkEntryClass GtkEntryClass; struct _GtkEntry { /*< private >*/ GtkWidget parent_instance; }; /** * GtkEntryClass: * @parent_class: The parent class. * @populate_popup: Class handler for the #GtkEntry::populate-popup signal. If * non-%NULL, this will be called to add additional entries to the context * menu when it is displayed. * @activate: Class handler for the #GtkEntry::activate signal. The default * implementation activates the gtk.activate-default action. * @move_cursor: Class handler for the #GtkEntry::move-cursor signal. The * default implementation specifies the standard #GtkEntry cursor movement * behavior. * @insert_at_cursor: Class handler for the #GtkEntry::insert-at-cursor signal. * The default implementation inserts text at the cursor. * @delete_from_cursor: Class handler for the #GtkEntry::delete-from-cursor * signal. The default implementation deletes the selection or the specified * number of characters or words. * @backspace: Class handler for the #GtkEntry::backspace signal. The default * implementation deletes the selection or a single character or word. * @cut_clipboard: Class handler for the #GtkEntry::cut-clipboard signal. The * default implementation cuts the selection, if one exists. * @copy_clipboard: Class handler for the #GtkEntry::copy-clipboard signal. The * default implementation copies the selection, if one exists. * @paste_clipboard: Class handler for the #GtkEntry::paste-clipboard signal. * The default implementation pastes at the current cursor position or over * the current selection if one exists. * @toggle_overwrite: Class handler for the #GtkEntry::toggle-overwrite signal. * The default implementation toggles overwrite mode and blinks the cursor. * @insert_emoji: Class handler for the #GtkEntry::insert-emoji signal. * * Class structure for #GtkEntry. All virtual functions have a default * implementation. Derived classes may set the virtual function pointers for the * signal handlers to %NULL, but must keep @get_text_area_size and * @get_frame_size non-%NULL; either use the default implementation, or provide * a custom one. */ struct _GtkEntryClass { GtkWidgetClass parent_class; /* Action signals */ void (* activate) (GtkEntry *entry); /*< private >*/ /* Padding for future expansion */ void (*_gtk_reserved1) (void); void (*_gtk_reserved2) (void); void (*_gtk_reserved3) (void); void (*_gtk_reserved4) (void); void (*_gtk_reserved5) (void); void (*_gtk_reserved6) (void); }; GDK_AVAILABLE_IN_ALL GType gtk_entry_get_type (void) G_GNUC_CONST; GDK_AVAILABLE_IN_ALL GtkWidget* gtk_entry_new (void); GDK_AVAILABLE_IN_ALL GtkWidget* gtk_entry_new_with_buffer (GtkEntryBuffer *buffer); GDK_AVAILABLE_IN_ALL GtkEntryBuffer* gtk_entry_get_buffer (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_buffer (GtkEntry *entry, GtkEntryBuffer *buffer); GDK_AVAILABLE_IN_ALL void gtk_entry_set_visibility (GtkEntry *entry, gboolean visible); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_visibility (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_invisible_char (GtkEntry *entry, gunichar ch); GDK_AVAILABLE_IN_ALL gunichar gtk_entry_get_invisible_char (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_unset_invisible_char (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_has_frame (GtkEntry *entry, gboolean setting); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_has_frame (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_overwrite_mode (GtkEntry *entry, gboolean overwrite); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_overwrite_mode (GtkEntry *entry); /* text is truncated if needed */ GDK_AVAILABLE_IN_ALL void gtk_entry_set_max_length (GtkEntry *entry, gint max); GDK_AVAILABLE_IN_ALL gint gtk_entry_get_max_length (GtkEntry *entry); GDK_AVAILABLE_IN_ALL guint16 gtk_entry_get_text_length (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_activates_default (GtkEntry *entry, gboolean setting); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_activates_default (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_alignment (GtkEntry *entry, gfloat xalign); GDK_AVAILABLE_IN_ALL gfloat gtk_entry_get_alignment (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_completion (GtkEntry *entry, GtkEntryCompletion *completion); GDK_AVAILABLE_IN_ALL GtkEntryCompletion *gtk_entry_get_completion (GtkEntry *entry); /* Progress API */ GDK_AVAILABLE_IN_ALL void gtk_entry_set_progress_fraction (GtkEntry *entry, gdouble fraction); GDK_AVAILABLE_IN_ALL gdouble gtk_entry_get_progress_fraction (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_progress_pulse_step (GtkEntry *entry, gdouble fraction); GDK_AVAILABLE_IN_ALL gdouble gtk_entry_get_progress_pulse_step (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_progress_pulse (GtkEntry *entry); GDK_AVAILABLE_IN_ALL const gchar* gtk_entry_get_placeholder_text (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_placeholder_text (GtkEntry *entry, const gchar *text); /* Setting and managing icons */ GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_from_paintable (GtkEntry *entry, GtkEntryIconPosition icon_pos, GdkPaintable *paintable); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_from_icon_name (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *icon_name); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_from_gicon (GtkEntry *entry, GtkEntryIconPosition icon_pos, GIcon *icon); GDK_AVAILABLE_IN_ALL GtkImageType gtk_entry_get_icon_storage_type (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL GdkPaintable * gtk_entry_get_icon_paintable (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL const gchar* gtk_entry_get_icon_name (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL GIcon* gtk_entry_get_icon_gicon (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_activatable (GtkEntry *entry, GtkEntryIconPosition icon_pos, gboolean activatable); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_icon_activatable (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_sensitive (GtkEntry *entry, GtkEntryIconPosition icon_pos, gboolean sensitive); GDK_AVAILABLE_IN_ALL gboolean gtk_entry_get_icon_sensitive (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL gint gtk_entry_get_icon_at_pos (GtkEntry *entry, gint x, gint y); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_tooltip_text (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *tooltip); GDK_AVAILABLE_IN_ALL gchar * gtk_entry_get_icon_tooltip_text (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_tooltip_markup (GtkEntry *entry, GtkEntryIconPosition icon_pos, const gchar *tooltip); GDK_AVAILABLE_IN_ALL gchar * gtk_entry_get_icon_tooltip_markup (GtkEntry *entry, GtkEntryIconPosition icon_pos); GDK_AVAILABLE_IN_ALL void gtk_entry_set_icon_drag_source (GtkEntry *entry, GtkEntryIconPosition icon_pos, GdkContentFormats *formats, GdkDragAction actions); GDK_AVAILABLE_IN_ALL gint gtk_entry_get_current_icon_drag_source (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_get_icon_area (GtkEntry *entry, GtkEntryIconPosition icon_pos, GdkRectangle *icon_area); GDK_AVAILABLE_IN_ALL void gtk_entry_reset_im_context (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_input_purpose (GtkEntry *entry, GtkInputPurpose purpose); GDK_AVAILABLE_IN_ALL GtkInputPurpose gtk_entry_get_input_purpose (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_input_hints (GtkEntry *entry, GtkInputHints hints); GDK_AVAILABLE_IN_ALL GtkInputHints gtk_entry_get_input_hints (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_attributes (GtkEntry *entry, PangoAttrList *attrs); GDK_AVAILABLE_IN_ALL PangoAttrList *gtk_entry_get_attributes (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_set_tabs (GtkEntry *entry, PangoTabArray *tabs); GDK_AVAILABLE_IN_ALL PangoTabArray *gtk_entry_get_tabs (GtkEntry *entry); GDK_AVAILABLE_IN_ALL void gtk_entry_grab_focus_without_selecting (GtkEntry *entry); G_END_DECLS #endif /* __GTK_ENTRY_H__ */