📄 gtkeditable.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>GtkEditable</title><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GTK+ Reference Manual"><link rel="up" href="NumericEntry.html" title="Numeric/Text Data Entry"><link rel="prev" href="GtkSpinButton.html" title="GtkSpinButton"><link rel="next" href="TextWidgetObjects.html" title="Multiline Text Editor"><meta name="generator" content="GTK-Doc V1.9 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="part" href="gtk.html" title="Part I. GTK+ Overview"><link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference"><link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects"><link rel="chapter" href="ch01.html" title="Object Hierarchy"><link rel="chapter" href="ch02.html" title="Widget Gallery"><link rel="chapter" href="WindowWidgets.html" title="Windows"><link rel="chapter" href="DisplayWidgets.html" title="Display Widgets"><link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles"><link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry"><link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor"><link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets"><link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar"><link rel="chapter" href="Actions.html" title="Action-based menus and toolbars"><link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)"><link rel="chapter" href="LayoutContainers.html" title="Layout Containers"><link rel="chapter" href="Ornaments.html" title="Ornaments"><link rel="chapter" href="ScrollingWidgets.html" title="Scrolling"><link rel="chapter" href="Printing.html" title="Printing"><link rel="chapter" href="MiscObjects.html" title="Miscellaneous"><link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes"><link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding"><link rel="chapter" href="SpecialObjects.html" title="Special-purpose features"><link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents"><link rel="chapter" href="Builder.html" title="Interface builder"><link rel="chapter" href="DeprecatedObjects.html" title="Deprecated"><link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+"><link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist"><link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser"><link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction"><link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and GtkComboBoxEntry"><link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView"><link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog"><link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton"><link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant"><link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser"><link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton"><link rel="chapter" href="gtk-migrating-GtkBuilder.html" title="Migrating from libglade to GtkBuilder"><link rel="chapter" href="gtk-migrating-tooltips.html" title="Migrating from GtkTooltips to GtkTooltip"><link rel="part" href="pt05.html" title="Part V. GTK+ Tools"><link rel="glossary" href="glossary.html" title="Glossary"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 2.2"><link rel="index" href="ix04.html" title="Index of new symbols in 2.4"><link rel="index" href="ix05.html" title="Index of new symbols in 2.6"><link rel="index" href="ix06.html" title="Index of new symbols in 2.8"><link rel="index" href="ix07.html" title="Index of new symbols in 2.10"><link rel="index" href="ix08.html" title="Index of new symbols in 2.12"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="GtkSpinButton.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="NumericEntry.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">GTK+ Reference Manual</th><td><a accesskey="n" href="TextWidgetObjects.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#id3556531" class="shortcut">Top</a>  |  <a href="#id3557065" class="shortcut">Description</a>  |  <a href="#id3556948" class="shortcut">Object Hierarchy</a>  |  <a href="#id3556973" class="shortcut">Known Implementations</a>  |  <a href="#id3557016" class="shortcut">Signals</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="GtkEditable"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><a name="id3556531"></a><span class="refentrytitle">GtkEditable</span></h2><p>GtkEditable — Interface for text-editing widgets</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">#include <gtk/gtk.h> <a class="link" href="GtkEditable.html#GtkEditable-struct">GtkEditable</a>;void <a class="link" href="GtkEditable.html#gtk-editable-select-region">gtk_editable_select_region</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> start, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> end);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkEditable.html#gtk-editable-get-selection-bounds">gtk_editable_get_selection_bounds</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *start, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *end);void <a class="link" href="GtkEditable.html#gtk-editable-insert-text">gtk_editable_insert_text</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, const <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a> *new_text, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> new_text_length, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> *position);void <a class="link" href="GtkEditable.html#gtk-editable-delete-text">gtk_editable_delete_text</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> start_pos, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> end_pos);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar">gchar</a>* <a class="link" href="GtkEditable.html#gtk-editable-get-chars">gtk_editable_get_chars</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> start_pos, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> end_pos);void <a class="link" href="GtkEditable.html#gtk-editable-cut-clipboard">gtk_editable_cut_clipboard</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);void <a class="link" href="GtkEditable.html#gtk-editable-copy-clipboard">gtk_editable_copy_clipboard</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);void <a class="link" href="GtkEditable.html#gtk-editable-paste-clipboard">gtk_editable_paste_clipboard</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);void <a class="link" href="GtkEditable.html#gtk-editable-delete-selection">gtk_editable_delete_selection</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);void <a class="link" href="GtkEditable.html#gtk-editable-set-position">gtk_editable_set_position</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> position);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> <a class="link" href="GtkEditable.html#gtk-editable-get-position">gtk_editable_get_position</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);void <a class="link" href="GtkEditable.html#gtk-editable-set-editable">gtk_editable_set_editable</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> is_editable);<ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkEditable.html#gtk-editable-get-editable">gtk_editable_get_editable</a> (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable);</pre></div><div class="refsect1" lang="en"><a name="id3556948"></a><h2>Object Hierarchy</h2><pre class="synopsis"> GInterface +----GtkEditable</pre></div><div class="refsect1" lang="en"><a name="id3556973"></a><h2>Known Implementations</h2><p>GtkEditable is implemented by <a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a>, <a class="link" href="GtkText.html" title="GtkText">GtkText</a>, <a class="link" href="GtkOldEditable.html" title="GtkOldEditable">GtkOldEditable</a> and <a class="link" href="GtkSpinButton.html" title="GtkSpinButton">GtkSpinButton</a>.</p></div><div class="refsect1" lang="en"><a name="id3557016"></a><h2>Signals</h2><pre class="synopsis"> "<a class="link" href="GtkEditable.html#GtkEditable-changed">changed</a>" : Run Last "<a class="link" href="GtkEditable.html#GtkEditable-delete-text">delete-text</a>" : Run Last "<a class="link" href="GtkEditable.html#GtkEditable-insert-text">insert-text</a>" : Run Last</pre></div><div class="refsect1" lang="en"><a name="id3557065"></a><h2>Description</h2><p>The <a class="link" href="GtkEditable.html" title="GtkEditable"><span class="type">GtkEditable</span></a> interface is an interface which should be implemented bytext editing widgets, such as <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a> and <a class="link" href="GtkText.html" title="GtkText"><span class="type">GtkText</span></a>. It contains functions for generically manipulating an editable widget, a large number of action signals used for key bindings, and several signals that an application can connect to to modify the behavior of a widget. </p><p>As an example of the latter usage, by connectingthe following handler to "insert_text", an applicationcan convert all entry into a widget into uppercase.</p><div class="example"><a name="id3557112"></a><p class="title"><b>Example 14. Forcing entry to uppercase.</b></p><div class="example-contents"><pre class="programlisting">#include <ctype.h>voidinsert_text_handler (GtkEditable *editable, const gchar *text, gint length, gint *position, gpointer data){ int i; gchar *result = g_utf8_strup (text, length); g_signal_handlers_block_by_func (editable, (gpointer) insert_text_handler, data); gtk_editable_insert_text (editable, result, length, position); g_signal_handlers_unblock_by_func (editable, (gpointer) insert_text_handler, data); g_signal_stop_emission_by_name (editable, "insert_text"); g_free (result);}</pre></div></div><p><br class="example-break"></p></div><div class="refsect1" lang="en"><a name="id3557149"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id3557159"></a><h3><a name="GtkEditable-struct"></a>GtkEditable</h3><a class="indexterm" name="id3557172"></a><pre class="programlisting">typedef struct _GtkEditable GtkEditable;</pre><p>The <a class="link" href="GtkEditable.html" title="GtkEditable"><span class="type">GtkEditable</span></a> structure contains the following fields.(These fields should be considered read-only. They shouldnever be set by an application.)</p><div class="informaltable"><table width="100%" border="0"><colgroup><col><col></colgroup><tbody><tr><td><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> selection_start;</td><td>the starting position of the selected characters in the widget.</td></tr><tr><td><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> selection_end;</td><td>the end position of the selected characters in the widget.</td></tr><tr><td><ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> editable;</td><td>a flag indicating whether or not the widget iseditable by the user.</td></tr></tbody></table></div><p></p></div><hr><div class="refsect2" lang="en"><a name="id3557278"></a><h3><a name="gtk-editable-select-region"></a>gtk_editable_select_region ()</h3><a class="indexterm" name="id3557291"></a><pre class="programlisting">void gtk_editable_select_region (<a class="link" href="GtkEditable.html" title="GtkEditable">GtkEditable</a> *editable, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> start, <ahref="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint">gint</a> end);</pre><p>Selects a region of text. The characters thatare selected are those characters at positions from<em class="parameter"><code>start_pos</code></em> up to, but not including <em class="parameter"><code>end_pos</code></em>. If <em class="parameter"><code>end_pos</code></em> is negative, then the the characters selected⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -