📄 gtkentry.html
字号:
<HTML><HEAD><TITLE>GtkEntry</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkEditable"HREF="gtkeditable.html"><LINKREL="NEXT"TITLE="GtkEventBox"HREF="gtkeventbox.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkeditable.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkeventbox.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKENTRY">GtkEntry</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN25291"></A><H2>Name</H2>GtkEntry -- a single line text entry field.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN25294"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkentry.html#GTKENTRY-STRUCT">GtkEntry</A>;<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkentry.html#GTK-ENTRY-NEW">gtk_entry_new</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkentry.html#GTK-ENTRY-NEW-WITH-MAX-LENGTH">gtk_entry_new_with_max_length</A> (<AHREF=../glib/glib-basic-types.html#GUINT16>guint16</A> max);void <AHREF="gtkentry.html#GTK-ENTRY-SET-TEXT">gtk_entry_set_text</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);void <AHREF="gtkentry.html#GTK-ENTRY-APPEND-TEXT">gtk_entry_append_text</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);void <AHREF="gtkentry.html#GTK-ENTRY-PREPEND-TEXT">gtk_entry_prepend_text</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);void <AHREF="gtkentry.html#GTK-ENTRY-SET-POSITION">gtk_entry_set_position</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> position);<AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A>* <AHREF="gtkentry.html#GTK-ENTRY-GET-TEXT">gtk_entry_get_text</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry);void <AHREF="gtkentry.html#GTK-ENTRY-SELECT-REGION">gtk_entry_select_region</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> start, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> end);void <AHREF="gtkentry.html#GTK-ENTRY-SET-VISIBILITY">gtk_entry_set_visibility</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> visible);void <AHREF="gtkentry.html#GTK-ENTRY-SET-EDITABLE">gtk_entry_set_editable</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> editable);void <AHREF="gtkentry.html#GTK-ENTRY-SET-MAX-LENGTH">gtk_entry_set_max_length</A> (<AHREF="gtkentry.html">GtkEntry</A> *entry, <AHREF=../glib/glib-basic-types.html#GUINT16>guint16</A> max); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN25331"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----<AHREF="gtkeditable.html">GtkEditable</A> +----GtkEntry</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN25337"></A><H2>Args</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> "<AHREF="gtkentry.html#GTKENTRY--MAX-LENGTH">max-length</A>" <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> : Read / Write "<AHREF="gtkentry.html#GTKENTRY--VISIBILITY">visibility</A>" <AHREF=../glib/glib-basic-types.html#GBOOLEAN>gboolean</A> : Read / Write</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN25344"></A><H2>Description</H2><P>The <AHREF="gtkentry.html">GtkEntry</A> widget is a single line text entrywidget. A fairly large set of key bindings are supportedby default. If the entered text is longer than the allocationof the widget, the widget will scroll so that the cursorposition is visible. </P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN25348"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN25350"></A><H3><ANAME="GTKENTRY-STRUCT"></A>struct GtkEntry</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkEntry;</PRE></TD></TR></TABLE><P>The <AHREF="gtkentry.html#GTKENTRY-STRUCT">GtkEntry</A> struct contains only private data.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN25356"></A><H3><ANAME="GTK-ENTRY-NEW"></A>gtk_entry_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_entry_new (void);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkentry.html">GtkEntry</A> widget.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN25363"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkentry.html">GtkEntry</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN25373"></A><H3><ANAME="GTK-ENTRY-NEW-WITH-MAX-LENGTH"></A>gtk_entry_new_with_max_length ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_entry_new_with_max_length (<AHREF=../glib/glib-basic-types.html#GUINT16>guint16</A> max);</PRE></TD></TR></TABLE><P>Creates a new <AHREF="gtkentry.html">GtkEntry</A> widget with the given maximumlength.</P><P>Note: the existance of this function is inconsistentwith the rest of the GTK+ API. The normal setup wouldbe to just require the user to make an extra callto <AHREF="gtkentry.html#GTK-ENTRY-SET-MAX-LENGTH">gtk_entry_set_max_length</A>() instead. It is notexpected that this function will be removed, butit would be better practice not to use it.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN25383"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>max</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the new maximum length.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a new <AHREF="gtkentry.html">GtkEntry</A>. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN25397"></A><H3><ANAME="GTK-ENTRY-SET-TEXT"></A>gtk_entry_set_text ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_entry_set_text (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);</PRE></TD></TR></TABLE><P>Sets the text in the widget to the givenvalue, replacing the current contents.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN25404"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>entry</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkentry.html">GtkEntry</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>text</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the new text. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN25418"></A><H3><ANAME="GTK-ENTRY-APPEND-TEXT"></A>gtk_entry_append_text ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_entry_append_text (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);</PRE></TD></TR></TABLE><P>Appends the given text to the contents of the widget.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN25425"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>entry</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkentry.html">GtkEntry</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>text</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the text to append. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN25439"></A><H3><ANAME="GTK-ENTRY-PREPEND-TEXT"></A>gtk_entry_prepend_text ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_entry_prepend_text (<AHREF="gtkentry.html">GtkEntry</A> *entry, const <AHREF=../glib/glib-basic-types.html#GCHAR>gchar</A> *text);</PRE></TD></TR></TABLE><P>Prepends the given text to the contents of th ewidget.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN25446"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>entry</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkentry.html">GtkEntry</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>text</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the text to prepend.⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -