mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-09-21 06:20:29 +00:00
gtkentry: Document vfuncs in GtkEntryClass
Clarify that the signal handler vfuncs can be NULL, nothing else can, and that they all have default implementations. https://bugzilla.gnome.org/show_bug.cgi?id=712760
This commit is contained in:
parent
52858f709c
commit
80013436d0
@ -1119,6 +1119,7 @@ gtk_editable_get_type
|
||||
<FILE>gtkentry</FILE>
|
||||
<TITLE>GtkEntry</TITLE>
|
||||
GtkEntry
|
||||
GtkEntryClass
|
||||
gtk_entry_new
|
||||
gtk_entry_new_with_buffer
|
||||
gtk_entry_get_buffer
|
||||
|
@ -79,6 +79,48 @@ struct _GtkEntry
|
||||
GtkEntryPrivate *priv;
|
||||
};
|
||||
|
||||
/**
|
||||
* 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 calls gtk_window_activate_default() on the entry’s top-level
|
||||
* window.
|
||||
* @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.
|
||||
* @get_text_area_size: Calculate the size of the text area, which is its
|
||||
* allocated width and requested height, minus space for margins and borders.
|
||||
* This virtual function must be non-%NULL.
|
||||
* @get_frame_size: Calculate the size of the text area frame, which is its
|
||||
* allocated width and requested height, minus space for margins and borders,
|
||||
* and taking baseline and text height into account. This virtual function
|
||||
* must be non-%NULL.
|
||||
*
|
||||
* 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;
|
||||
@ -117,6 +159,8 @@ struct _GtkEntryClass
|
||||
gint *width,
|
||||
gint *height);
|
||||
|
||||
/*< private >*/
|
||||
|
||||
/* Padding for future expansion */
|
||||
void (*_gtk_reserved1) (void);
|
||||
void (*_gtk_reserved2) (void);
|
||||
|
Loading…
Reference in New Issue
Block a user