gtkentry.html

来自「最新gtk中文资料集」· HTML 代码 · 共 1,305 行 · 第 1/5 页

<td> the current invisible char, or 0, if the entry does not
              show invisible text at all. 
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522129"></a><h3>
<a name="gtk-entry-set-alignment"></a>gtk_entry_set_alignment ()</h3>
<a class="indexterm" name="id3522144"></a><pre class="programlisting">void                gtk_entry_set_alignment             (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a> xalign);</pre>
<p>
Sets the alignment for the contents of the entry. This controls
the horizontal positioning of the contents when the displayed
text is shorter than the width of the entry.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xalign</code></em>&#160;:</span></p></td>
<td> The horizontal alignment, from 0 (left) to 1 (right).
         Reversed for RTL layouts
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522234"></a><h3>
<a name="gtk-entry-get-alignment"></a>gtk_entry_get_alignment ()</h3>
<a class="indexterm" name="id3522249"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gfloat"
>gfloat</a>              gtk_entry_get_alignment             (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry);</pre>
<p>
Gets the value set by <a class="link" href="GtkEntry.html#gtk-entry-set-alignment"><code class="function">gtk_entry_set_alignment()</code></a>.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the alignment

</td>
</tr>
</tbody>
</table></div>
<p class="since">Since  2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522335"></a><h3>
<a name="gtk-entry-get-layout"></a>gtk_entry_get_layout ()</h3>
<a class="indexterm" name="id3522348"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
>PangoLayout</a>*        gtk_entry_get_layout                (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry);</pre>
<p>
Gets the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> used to display the entry.
The layout is useful to e.g. convert text positions to
pixel positions, in combination with <a class="link" href="GtkEntry.html#gtk-entry-get-layout-offsets"><code class="function">gtk_entry_get_layout_offsets()</code></a>.
The returned layout is owned by the entry and must not be 
modified or freed by the caller.
</p>
<p>
Keep in mind that the layout text may contain a preedit string, so
<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and
<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte
indices in the layout to byte indices in the entry contents.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> for this entry
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522476"></a><h3>
<a name="gtk-entry-get-layout-offsets"></a>gtk_entry_get_layout_offsets ()</h3>
<a class="indexterm" name="id3522490"></a><pre class="programlisting">void                gtk_entry_get_layout_offsets        (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *x,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *y);</pre>
<p>
Obtains the position of the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> used to render text
in the entry, in widget coordinates. Useful if you want to line
up the text in an entry with some other text, e.g. when using the
entry to implement editable cells in a sheet widget.
</p>
<p>
Also useful to convert mouse events into coordinates inside the
<a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a>, e.g. to take some action if some part of the entry text
is clicked.
</p>
<p>
Note that as the user scrolls around in the entry the offsets will
change; you'll need to connect to the "notify::scroll-offset"
signal to track this. Remember when using the <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a>
functions you need to convert to and from pixels using
<a
href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-PIXELS:CAPS"
><code class="function">PANGO_PIXELS()</code></a> or <a
href="/usr/share/gtk-doc/html/pango/pango-Glyph-Storage.html#PANGO-SCALE:CAPS"
><span class="type">PANGO_SCALE</span></a>.
</p>
<p>
Keep in mind that the layout text may contain a preedit string, so
<a class="link" href="GtkEntry.html#gtk-entry-layout-index-to-text-index"><code class="function">gtk_entry_layout_index_to_text_index()</code></a> and
<a class="link" href="GtkEntry.html#gtk-entry-text-index-to-layout-index"><code class="function">gtk_entry_text_index_to_layout_index()</code></a> are needed to convert byte
indices in the layout to byte indices in the entry contents.</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>x</code></em>&#160;:</span></p></td>
<td> location to store X offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>y</code></em>&#160;:</span></p></td>
<td> location to store Y offset of layout, or <a
href="/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522700"></a><h3>
<a name="gtk-entry-layout-index-to-text-index"></a>gtk_entry_layout_index_to_text_index ()</h3>
<a class="indexterm" name="id3522714"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_entry_layout_index_to_text_index
                                                        (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> layout_index);</pre>
<p>
Converts from a position in the entry contents (returned
by <a class="link" href="GtkEntry.html#gtk-entry-get-text"><code class="function">gtk_entry_get_text()</code></a>) to a position in the
entry's <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> (returned by <a class="link" href="GtkEntry.html#gtk-entry-get-layout"><code class="function">gtk_entry_get_layout()</code></a>,
with text retrieved via <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#pango-layout-get-text"
><code class="function">pango_layout_get_text()</code></a>).</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>layout_index</code></em>&#160;:</span></p></td>
<td> byte index into the entry layout text
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> byte index into the entry contents
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3522849"></a><h3>
<a name="gtk-entry-text-index-to-layout-index"></a>gtk_entry_text_index_to_layout_index ()</h3>
<a class="indexterm" name="id3522863"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a>                gtk_entry_text_index_to_layout_index
                                                        (<a class="link" href="GtkEntry.html" title="GtkEntry">GtkEntry</a> *entry,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> text_index);</pre>
<p>
Converts from a position in the entry's <a
href="/usr/share/gtk-doc/html/pango/pango-Layout-Objects.html#PangoLayout"
><span class="type">PangoLayout</span></a> (returned by
<a class="link" href="GtkEntry.html#gtk-entry-get-layout"><code class="function">gtk_entry_get_layout()</code></a>) to a position in the entry contents
(returned by <a class="link" href="GtkEntry.html#gtk-entry-get-text"><code class="function">gtk_entry_get_text()</code></a>).</p>
<p>

</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>entry</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkEntry.html" title="GtkEntry"><span class="type">GtkEntry</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text_index</code></em>&#160;:</span></p></td>
<td> byte i