<html> <head><title>Gtk-- Reference: Gtk::Entry</title></head> <body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#000077" alink="#FF0000"> <table align=center border=0 cellspacing=10> <tr> <td><a href="class_index.html">Class Index</a></td> <td><a href="cross_index.html">Cross Index</a></td> <td><a href="name_index.html">Namespace Index</a></td> </table> <h1 align=center>Class Gtk::Entry</h1><p> <b> A single line text entry field.</b><br> Contained in: <a href="Gtk.html">Gtk</a><br> Derived from: <a href="Gtk%3A%3AEditable.html">Gtk::Editable</a> <br> Derived by: <a href="Gtk::SpinButton.html">Gtk::SpinButton</a> <p> #include <gtk--/entry.h> <p> <hr noshade> <table border=0> <tr><td colspan=3><h3>public function member index:</h3></td> <tr valign=top><td align=right><tt><tt>explicit</tt> </tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1460"><tt><font color=blue><b>Entry</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>max</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1461"><tt><font color=blue><b>Entry</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1465"><tt><font color=blue><b>append_text</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>string</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1463"><tt><font color=blue><b>get_text</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>unsigned</font></tt> <tt><font color=purple>int</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1464"><tt><font color=blue><b>get_text_length</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt><font color=navy>GtkEntry</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1456"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>()</tt>;</td> <tr valign=top><td align=right><tt><tt>const</tt> <tt><font color=navy>GtkEntry</font></tt>*</tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1457"><tt><font color=blue><b>gtkobj</b></font></tt></a></td><td><tt>() <tt>const</tt></tt>;</td> <tr valign=top><td align=right><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1458"><tt><font color=blue><b>isA</b></font></tt></a></td><td><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1466"><tt><font color=blue><b>prepend_text</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1467"><tt><font color=blue><b>select_region</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>start</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>end</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1470"><tt><font color=blue><b>set_max_length</b></font></tt></a></td><td><tt>(<tt><font color=purple>guint16</font></tt> <tt><font color=blue>max</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1468"><tt><font color=blue><b>set_position</b></font></tt></a></td><td><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>position</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1462"><tt><font color=blue><b>set_text</b></font></tt></a></td><td><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt><font color=purple>void</font></tt></tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1469"><tt><font color=blue><b>set_visibility</b></font></tt></a></td><td><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>visible</font></tt>)</tt>;</td> <tr valign=top><td align=right><tt><tt>virtual</tt> </tt> </td><td align=right><a href="Gtk%3A%3AEntry.html#1459"><tt><font color=blue><b>~Entry</b></font></tt></a></td><td><tt>()</tt>;</td> <tr><td> </td></table> <hr noshade> <h2>Description:</h2> 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.<br> <p> <hr noshade> <h2>Function Member Descriptions:</h2> <a name="1460"><font size=+1><b>Gtk::Entry::Entry</b></font></a> - Creates a new <tt><font color=navy><b>Gtk::Entry</b></font></tt> widget with the given maximum length.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>explicit</tt> </tt> <a href="Gtk%3A%3AEntry.html#1460"><tt><font color=blue><b>Entry</b></font></tt></a><tt>(<tt><font color=purple>guint</font></tt> <tt><font color=blue>max</font></tt>)</tt>;<br><blockquote> max: The new maximum length.</blockquote> <br><br> <a name="1465"><font size=+1><b>Gtk::Entry::append_text</b></font></a> - Appends the given text to the contents of the widget.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1465"><tt><font color=blue><b>append_text</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;<br><blockquote> text: The text to append.</blockquote> <br><br> <a name="1463"><font size=+1><b>Gtk::Entry::get_text</b></font></a> - Retrieve the contents of the entry widget.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>string</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1463"><tt><font color=blue><b>get_text</b></font></tt></a><tt>() <tt>const</tt></tt>;<br><blockquote> Returns: The contents of the text widget as a string.</blockquote> <br><br> <a name="1456"><font size=+1><b>Gtk::Entry::gtkobj</b></font></a> - Returns the underlaying gtk+ object.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=navy>GtkEntry</font></tt>*</tt> <a href="Gtk%3A%3AEntry.html#1456"><tt><font color=blue><b>gtkobj</b></font></tt></a><tt>()</tt>;<br><br> <a name="1458"><font size=+1><b>Gtk::Entry::isA</b></font></a> - Returns true if object is this type.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt>static</tt> <tt><font color=purple>bool</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1458"><tt><font color=blue><b>isA</b></font></tt></a><tt>(<a href="Gtk%3A%3AObject.html"><tt><font color=navy><b>Object</b></font></tt></a>* <tt><font color=blue>object</font></tt>)</tt>;<br><br> <a name="1466"><font size=+1><b>Gtk::Entry::prepend_text</b></font></a> - Prepends the given text to the contents of the widget.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1466"><tt><font color=blue><b>prepend_text</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;<br><blockquote> text: The text to prepend.</blockquote> <br><br> <a name="1467"><font size=+1><b>Gtk::Entry::select_region</b></font></a> - Selects a region of text.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1467"><tt><font color=blue><b>select_region</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>start</font></tt>, <tt><font color=purple>gint</font></tt> <tt><font color=blue>end</font></tt>)</tt>;<br><blockquote> The characters that are selected are those characters at positions from start_pos up to, but not including end_pos. If end_pos is negative, then the characters selected will be those characters from start_pos to the end of the text. <P> start: The starting position. <P> end: The end position.</blockquote> <br><br> <a name="1470"><font size=+1><b>Gtk::Entry::set_max_length</b></font></a> - Sets the maximum allowed length of the contents of the widget.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1470"><tt><font color=blue><b>set_max_length</b></font></tt></a><tt>(<tt><font color=purple>guint16</font></tt> <tt><font color=blue>max</font></tt>)</tt>;<br><blockquote> If the current contents are longer than the given length, then they will be truncated to fit. <P> max: The new maximum length.</blockquote> <br><br> <a name="1468"><font size=+1><b>Gtk::Entry::set_position</b></font></a> - Sets the cursor position in an entry to the given value.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1468"><tt><font color=blue><b>set_position</b></font></tt></a><tt>(<tt><font color=purple>gint</font></tt> <tt><font color=blue>position</font></tt>)</tt>;<br><blockquote> position: The position of the cursor. The cursor is displayed before the character with the given (base 0) index in the widget. The value must be less than or equal to the number of characters in the widget. A value of -1 indicates that the position should be set after the last character in the entry. Note that this position is in characters, not in bytes.</blockquote> <br><br> <a name="1462"><font size=+1><b>Gtk::Entry::set_text</b></font></a> - Sets the text in the widget to the given value, replacing the current contents.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1462"><tt><font color=blue><b>set_text</b></font></tt></a><tt>(<tt>const</tt> <tt><font color=navy>string</font></tt>& <tt><font color=blue>text</font></tt>)</tt>;<br><blockquote> text: The new text.</blockquote> <br><br> <a name="1469"><font size=+1><b>Gtk::Entry::set_visibility</b></font></a> - Sets whether the contents of the entry are visible or not.<br> <hr size="1" width="70%" align="left" noshade="noshade"><tt><tt><font color=purple>void</font></tt></tt> <a href="Gtk%3A%3AEntry.html#1469"><tt><font color=blue><b>set_visibility</b></font></tt></a><tt>(<tt><font color=purple>bool</font></tt> <tt><font color=blue>visible</font></tt>)</tt>;<br><blockquote> When visibility is set to FALSE, characters are displayed as asterisks (*'s), and will also appear that way when the text in the entry widget is copied elsewhere. <P> visible: TRUE if the contents of the entry are displayed as plaintext.</blockquote> <br><br> <hr noshade> </html>
distrib
>
Mandriva
>
9.1
>
ppc
>
media
>
main
>
by-pkgid
>
ca81b57b553ae75608ba0fc5e7925e4e
>
files
>
331
