gtkimcontext.html

最新gtk中文资料集

<td> location to store position of cursor (in characters)
             within the preedit string.  
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392288"></a><h3>
<a name="gtk-im-context-filter-keypress"></a>gtk_im_context_filter_keypress ()</h3>
<a class="indexterm" name="id4392302"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_im_context_filter_keypress      (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Event-Structures.html#GdkEventKey"
>GdkEventKey</a> *event);</pre>
<p>
Allow an input method to internally handle key press and release 
events. If this function returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, then no further processing
should be done for this key event.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>event</code></em>&#160;:</span></p></td>
<td> the key event
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
<td> <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a> if the input method handled the key event.

</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392416"></a><h3>
<a name="gtk-im-context-focus-in"></a>gtk_im_context_focus_in ()</h3>
<a class="indexterm" name="id4392429"></a><pre class="programlisting">void                gtk_im_context_focus_in             (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context);</pre>
<p>
Notify the input method that the widget to which this
input context corresponds has gained focus. The input method
may, for example, change the displayed feedback to reflect
this change.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392491"></a><h3>
<a name="gtk-im-context-focus-out"></a>gtk_im_context_focus_out ()</h3>
<a class="indexterm" name="id4392504"></a><pre class="programlisting">void                gtk_im_context_focus_out            (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context);</pre>
<p>
Notify the input method that the widget to which this
input context corresponds has lost focus. The input method
may, for example, change the displayed feedback or reset the contexts
state to reflect this change.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392566"></a><h3>
<a name="gtk-im-context-reset"></a>gtk_im_context_reset ()</h3>
<a class="indexterm" name="id4392578"></a><pre class="programlisting">void                gtk_im_context_reset                (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context);</pre>
<p>
Notify the input method that a change such as a change in cursor
position has been made. This will typically cause the input
method to clear the preedit state.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392639"></a><h3>
<a name="gtk-im-context-set-cursor-location"></a>gtk_im_context_set_cursor_location ()</h3>
<a class="indexterm" name="id4392653"></a><pre class="programlisting">void                gtk_im_context_set_cursor_location  (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,
                                                         <a
href="/usr/share/gtk-doc/html/gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle"
>GdkRectangle</a> *area);</pre>
<p>
Notify the input method that a change in cursor 
position has been made. The location is relative to the client
window.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>area</code></em>&#160;:</span></p></td>
<td> new location
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392735"></a><h3>
<a name="gtk-im-context-set-use-preedit"></a>gtk_im_context_set_use_preedit ()</h3>
<a class="indexterm" name="id4392749"></a><pre class="programlisting">void                gtk_im_context_set_use_preedit      (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> use_preedit);</pre>
<p>
Sets whether the IM context should use the preedit string
to display feedback. If <em class="parameter"><code>use_preedit</code></em> is FALSE (default
is TRUE), then the IM context may use some other method to display
feedback, such as displaying it in a child of the root window.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>use_preedit</code></em>&#160;:</span></p></td>
<td> whether the IM context should use the preedit string.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4392840"></a><h3>
<a name="gtk-im-context-set-surrounding"></a>gtk_im_context_set_surrounding ()</h3>
<a class="indexterm" name="id4392853"></a><pre class="programlisting">void                gtk_im_context_set_surrounding      (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,
                                                         const <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> *text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> len,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> cursor_index);</pre>
<p>
Sets surrounding context around the insertion point and preedit
string. This function is expected to be called in response to the
GtkIMContext::retrieve_surrounding signal, and will likely have no
effect if called at other times.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a> 
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
<td> text surrounding the insertion point, as UTF-8.
       the preedit string should not be included within
       <em class="parameter"><code>text</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>len</code></em>&#160;:</span></p></td>
<td> the length of <em class="parameter"><code>text</code></em>, or -1 if <em class="parameter"><code>text</code></em> is nul-terminated
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor_index</code></em>&#160;:</span></p></td>
<td> the byte index of the insertion cursor within <em class="parameter"><code>text</code></em>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id4393006"></a><h3>
<a name="gtk-im-context-get-surrounding"></a>gtk_im_context_get_surrounding ()</h3>
<a class="indexterm" name="id4393020"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a>            gtk_im_context_get_surrounding      (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"
>gchar</a> **text,
                                                         <a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"
>gint</a> *cursor_index);</pre>
<p>
Retrieves context around the insertion point. Input methods
typically want context in order to constrain input text based on
existing text; this is important for languages such as Thai where
only some sequences of characters are allowed.
</p>
<p>
This function is implemented by emitting the
GtkIMContext::retrieve_surrounding signal on the input method; in
response to this signal, a widget should provide as much context as
is available, up to an entire paragraph, by calling
<a class="link" href="GtkIMContext.html#gtk-im-context-set-surrounding"><code class="function">gtk_im_context_set_surrounding()</code></a>. Note that there is no obligation
for a widget to respond to the ::retrieve_surrounding signal, so input
methods must be prepared to function without context.</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>context</code></em>&#160;:</span></p></td>
<td> a <a class="link" href="GtkIMContext.html" title="GtkIMContext"><span class="type">GtkIMContext</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></p></td>
<td> location to store a UTF-8 encoded string of text
       holding context around the insertion point.
       If the function returns <a
href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"
><code class="literal">TRUE</code></a>, then you must free
       the result stored in this location with <a
href="/usr/share/gtk-doc/html/glib/glib-Memory-Allocation.html#g-free"
><code class="function">g_free()</code></a>.
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>cursor_index</code></em>&#160;:</span></p></td>
<td> location to store byte index of the insertion cursor
       within <em class="parameter"><code>text</code></em>.
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>