forked from AuroraMiddleware/gtk
673 lines
8.9 KiB
Plaintext
673 lines
8.9 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkEntry
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
A single line text entry field
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
The #GtkEntry widget is a single line text entry
|
|
widget. A fairly large set of key bindings are supported
|
|
by default. If the entered text is longer than the allocation
|
|
of the widget, the widget will scroll so that the cursor
|
|
position is visible.
|
|
</para>
|
|
<para>
|
|
Since 2.16, GtkEntry has the ability to display progress or activity
|
|
information behind the text. To make an entry display progress or activity
|
|
information, use gtk_entry_set_progress_fraction() or
|
|
gtk_entry_set_progress_pulse_step().
|
|
</para>
|
|
<para>
|
|
Additionally, GtkEntry can show icons at either side of the entry. These
|
|
icons can be activatable by clicking, can be set up as drag source and
|
|
can have tooltips. To add an icon, use gtk_entry_set_icon_from_gicon() or
|
|
one of the various other functions that set an icon from a stock id, an
|
|
icon name or a pixbuf.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
<variablelist>
|
|
|
|
<varlistentry>
|
|
<term>#GtkTextView</term>
|
|
<listitem><para>a widget for handling multi-line text entry.</para></listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry>
|
|
<term>#GtkEntryCompletion</term>
|
|
<listitem><para>adds completion functionality to GtkEntry.</para></listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
</para>
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkEntry ##### -->
|
|
<para>
|
|
The #GtkEntry-struct struct contains only private data.
|
|
</para>
|
|
|
|
|
|
<!-- ##### SIGNAL GtkEntry::activate ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkEntry::backspace ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkEntry::copy-clipboard ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkEntry::cut-clipboard ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkEntry::delete-from-cursor ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
@arg2:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::icon-pressed ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
@event:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::icon-released ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
@event:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::insert-at-cursor ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::move-cursor ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
@arg2:
|
|
@arg3:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::paste-clipboard ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### SIGNAL GtkEntry::populate-popup ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
@arg1:
|
|
|
|
<!-- ##### SIGNAL GtkEntry::toggle-overwrite ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry: the object which received the signal.
|
|
|
|
<!-- ##### ARG GtkEntry:activatable-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:activatable-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:activates-default ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:caps-lock-warning ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:cursor-position ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:editable ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:gicon-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:gicon-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:has-frame ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:icon-name-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:icon-name-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:inner-border ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:invisible-char ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:invisible-char-set ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:max-length ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:overwrite-mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:pixbuf-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:pixbuf-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:progress-fraction ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:progress-pulse-step ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:scroll-offset ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:selection-bound ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:sensitive-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:sensitive-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:shadow-type ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:stock-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:stock-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:storage-type-primary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:storage-type-secondary ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:text-length ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:truncate-multiline ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:visibility ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:width-chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:xalign ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:inner-border ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:prelight ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### ARG GtkEntry:state-hint ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gtk_entry_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_new_with_max_length ##### -->
|
|
<para>
|
|
</para>
|
|
|
|
@max:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@text:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_append_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@text:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_prepend_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@text:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_position ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@position:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_text ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_text_length ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_select_region ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@start:
|
|
@end:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_visibility ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@visible:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_invisible_char ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@ch:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_unset_invisible_char ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_editable ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@editable:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_max_length ##### -->
|
|
<para>
|
|
</para>
|
|
|
|
@entry:
|
|
@max:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_activates_default ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_has_frame ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_inner_border ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_width_chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_activates_default ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@setting:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_has_frame ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@setting:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_inner_border ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@border:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_width_chars ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@n_chars:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_invisible_char ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_alignment ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@xalign:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_alignment ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_overwrite_mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@overwrite:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_overwrite_mode ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_layout ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_layout_offsets ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@x:
|
|
@y:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_layout_index_to_text_index ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@layout_index:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_text_index_to_layout_index ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@text_index:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_max_length ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_visibility ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_completion ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@completion:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_completion ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_set_cursor_hadjustment ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@adjustment:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_entry_get_cursor_hadjustment ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@entry:
|
|
@Returns:
|
|
|
|
|