~ubuntu-branches/debian/experimental/gtk+2.0/experimental

void <a class="link" href="GtkIMContext.html#gtk-im-context-set-client-window" title="gtk_im_context_set_client_window ()">gtk_im_context_set_client_window</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow">GdkWindow</a> *window</code>);

<code><a href="../gdk/gdk-Windows.html#GdkWindow">GdkWindow</a> *window</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-get-preedit-string" title="gtk_im_context_get_preedit_string ()">gtk_im_context_get_preedit_string</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **str</code>,

<code>gchar **str</code>,

<code>PangoAttrList **attrs</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *cursor_pos</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIMContext.html#gtk-im-context-filter-keypress" title="gtk_im_context_filter_keypress ()">gtk_im_context_filter_keypress</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>);

<code>gint *cursor_pos</code>);

gboolean <a class="link" href="GtkIMContext.html#gtk-im-context-filter-keypress" title="gtk_im_context_filter_keypress ()">gtk_im_context_filter_keypress</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-focus-in" title="gtk_im_context_focus_in ()">gtk_im_context_focus_in</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-focus-out" title="gtk_im_context_focus_out ()">gtk_im_context_focus_out</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-reset" title="gtk_im_context_reset ()">gtk_im_context_reset</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-set-cursor-location" title="gtk_im_context_set_cursor_location ()">gtk_im_context_set_cursor_location</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code>const <a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *area</code>);

<code>const <a href="../gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *area</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-set-use-preedit" title="gtk_im_context_set_use_preedit ()">gtk_im_context_set_use_preedit</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_preedit</code>);

<code>gboolean use_preedit</code>);

void <a class="link" href="GtkIMContext.html#gtk-im-context-set-surrounding" title="gtk_im_context_set_surrounding ()">gtk_im_context_set_surrounding</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *text</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> len</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> cursor_index</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIMContext.html#gtk-im-context-get-surrounding" title="gtk_im_context_get_surrounding ()">gtk_im_context_get_surrounding</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **text</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *cursor_index</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="GtkIMContext.html#gtk-im-context-delete-surrounding" title="gtk_im_context_delete_surrounding ()">gtk_im_context_delete_surrounding</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> offset</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_chars</code>);

<code>const gchar *text</code>,

<code>gint len</code>,

<code>gint cursor_index</code>);

gboolean <a class="link" href="GtkIMContext.html#gtk-im-context-get-surrounding" title="gtk_im_context_get_surrounding ()">gtk_im_context_get_surrounding</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code>gchar **text</code>,

<code>gint *cursor_index</code>);

gboolean <a class="link" href="GtkIMContext.html#gtk-im-context-delete-surrounding" title="gtk_im_context_delete_surrounding ()">gtk_im_context_delete_surrounding</a> (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

<code>gint offset</code>,

<code>gint n_chars</code>);

</pre>

</div>

<a name="GtkIMContext.object-hierarchy"></a><h2>Object Hierarchy</h2>

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>

GObject

+----GtkIMContext

+----<a class="link" href="GtkIMContextSimple.html" title="GtkIMContextSimple">GtkIMContextSimple</a>

+----<a class="link" href="GtkIMMulticontext.html" title="GtkIMMulticontext">GtkIMMulticontext</a>

<a name="GtkIMContext.signals"></a><h2>Signals</h2>

"<a class="link" href="GtkIMContext.html#GtkIMContext-commit" title='The "commit" signal'>commit</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-delete-surrounding" title='The "delete-surrounding" signal'>delete-surrounding</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-changed" title='The "preedit-changed" signal'>preedit-changed</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-end" title='The "preedit-end" signal'>preedit-end</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-start" title='The "preedit-start" signal'>preedit-start</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-retrieve-surrounding" title='The "retrieve-surrounding" signal'>retrieve-surrounding</a>" : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>

"<a class="link" href="GtkIMContext.html#GtkIMContext-commit" title='The "commit" signal'>commit</a>" : <code class="literal">Run Last</code>

"<a class="link" href="GtkIMContext.html#GtkIMContext-delete-surrounding" title='The "delete-surrounding" signal'>delete-surrounding</a>" : <code class="literal">Run Last</code>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-changed" title='The "preedit-changed" signal'>preedit-changed</a>" : <code class="literal">Run Last</code>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-end" title='The "preedit-end" signal'>preedit-end</a>" : <code class="literal">Run Last</code>

"<a class="link" href="GtkIMContext.html#GtkIMContext-preedit-start" title='The "preedit-start" signal'>preedit-start</a>" : <code class="literal">Run Last</code>

"<a class="link" href="GtkIMContext.html#GtkIMContext-retrieve-surrounding" title='The "retrieve-surrounding" signal'>retrieve-surrounding</a>" : <code class="literal">Run Last</code>

</pre>

</div>

147

</div>

148

149

150

This function should register the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GType">GType</a> of the <a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> subclass which

151

implements the input method by means of <a href="http://library.gnome.org/devel/gobject/unstable/GTypeModule.html#g-type-module-register-type"><code class="function">g_type_module_register_type()</code></a>. Note

152

that <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#g-type-register-static"><code class="function">g_type_register_static()</code></a> cannot be used as the type needs to be

150

This function should register the GType of the <a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> subclass which

151

implements the input method by means of <code class="function">g_type_module_register_type()</code>. Note

152

that <code class="function">g_type_register_static()</code> cannot be used as the type needs to be

153

registered dynamically.

154

155

182

<td class="listing_code"><pre class="programlisting">void im_module_list(const <a class="link" href="GtkIMContext.html#GtkIMContextInfo" title="struct GtkIMContextInfo">GtkIMContextInfo</a> ***contexts, int *n_contexts)

183

{

184

*contexts = info_list;

185

*n_contexts = <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Macros.html#G-N-ELEMENTS:CAPS">G_N_ELEMENTS</a> (info_list);

185

*n_contexts = G_N_ELEMENTS (info_list);

186

}</pre></td>

187

</tr>

188

</tbody>

317

<td>Called via <a class="link" href="GtkIMContext.html#gtk-im-context-filter-keypress" title="gtk_im_context_filter_keypress ()"><code class="function">gtk_im_context_filter_keypress()</code></a> on every

318

key press or release event. Every non-trivial input method needs to

319

override this in order to implement the mapping from key events to text.

320

A return value of <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> indicates to the caller that the event was

320

A return value of <code class="literal">TRUE</code> indicates to the caller that the event was

321

consumed by the input method. In that case, the <a class="link" href="GtkIMContext.html#GtkIMContext-commit" title='The "commit" signal'>"commit"</a>

322

signal should be emitted upon completion of a key sequence to pass the

323

resulting text back to the input widget. Alternatively, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> may be

323

resulting text back to the input widget. Alternatively, <code class="literal">FALSE</code> may be

324

returned to indicate that the event wasn't handled by the input method.

325

If a builtin mapping exists for the key, it is used to produce a

326

character.</td>

393

394

<tbody>

395

<tr>

396

<td>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GtkIMContextInfo.context-id"></a>context_id</code>;</td>

396

<td>const gchar *<code><a name="GtkIMContextInfo.context-id"></a>context_id</code>;</td>

397

<td>The unique identification string of the input method.</td>

398

</tr>

399

<tr>

400

<td>const gchar *<code><a name="GtkIMContextInfo.context-name"></a>context_name</code>;</td>

401

<td>The human-readable name of the input method.</td>

402

</tr>

403

<tr>

404

<td>const gchar *<code><a name="GtkIMContextInfo.domain"></a>domain</code>;</td>

405

<td>Translation domain to be used with <code class="function">dgettext()</code>

406

</td>

407

</tr>

408

<tr>

409

<td>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GtkIMContextInfo.domain-dirname"></a>domain_dirname</code>;</td>

409

<td>const gchar *<code><a name="GtkIMContextInfo.domain-dirname"></a>domain_dirname</code>;</td>

410

<td>Name of locale directory for use with <code class="function">bindtextdomain()</code>

411

</td>

412

</tr>

413

<tr>

414

<td>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *<code><a name="GtkIMContextInfo.default-locales"></a>default_locales</code>;</td>

414

<td>const gchar *<code><a name="GtkIMContextInfo.default-locales"></a>default_locales</code>;</td>

415

<td>A colon-separated list of locales where this input method

416

should be the default. The asterisk "*" sets the default for all locales.</td>

417

</tr>

422

423

<a name="gtk-im-context-set-client-window"></a><h3>gtk_im_context_set_client_window ()</h3>

424

<pre class="programlisting">void gtk_im_context_set_client_window (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

425

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow">GdkWindow</a> *window</code>);</pre>

425

<code><a href="../gdk/gdk-Windows.html#GdkWindow">GdkWindow</a> *window</code>);</pre>

426

427

Set the client window for the input context; this is the

428

<a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow">GdkWindow</a> in which the input appears. This window is

428

<a href="../gdk/gdk-Windows.html#GdkWindow">GdkWindow</a> in which the input appears. This window is

429

used in order to correctly position status windows, and may

430

also be used for purposes internal to the input method.

431

439

</tr>

440

<tr>

441

<td><code>window</code> :</td>

442

<td>the client window. This may be <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to indicate

442

<td>the client window. This may be <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> to indicate

443

that the previous client window no longer exists. [<acronym title="NULL is ok, both for passing and for returning.">allow-none</acronym>]

444

</td>

445

</tr>

450

451

<a name="gtk-im-context-get-preedit-string"></a><h3>gtk_im_context_get_preedit_string ()</h3>

452

<pre class="programlisting">void gtk_im_context_get_preedit_string (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

453

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **str</code>,

453

<code>gchar **str</code>,

454

<code>PangoAttrList **attrs</code>,

455

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *cursor_pos</code>);</pre>

455

<code>gint *cursor_pos</code>);</pre>

456

457

Retrieve the current preedit string for the input context,

458

and a list of attributes to apply to the string.

470

<tr>

471

472

<td>location to store the retrieved

473

string. The string retrieved must be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

473

string. The string retrieved must be freed with <code class="function">g_free()</code>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

474

</td>

475

</tr>

476

<tr>

492

<hr>

493

494

<a name="gtk-im-context-filter-keypress"></a><h3>gtk_im_context_filter_keypress ()</h3>

495

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_im_context_filter_keypress (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

496

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>);</pre>

495

<pre class="programlisting">gboolean gtk_im_context_filter_keypress (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

496

<code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>);</pre>

497

498

Allow an input method to internally handle key press and release

499

events. If this function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then no further processing

499

events. If this function returns <code class="literal">TRUE</code>, then no further processing

500

should be done for this key event.

501

502

514

<tr>

515

<td>Returns :</td>

516

<td>

517

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the input method handled the key event.</td>

517

<code class="literal">TRUE</code> if the input method handled the key event.</td>

518

</tr>

519

</tbody>

520

</table></div>

579

580

<a name="gtk-im-context-set-cursor-location"></a><h3>gtk_im_context_set_cursor_location ()</h3>

581

<pre class="programlisting">void gtk_im_context_set_cursor_location (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

582

<code>const <a href="http://library.gnome.org/devel/gdk3/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *area</code>);</pre>

582

<code>const <a href="../gdk/gdk-Points-Rectangles-and-Regions.html#GdkRectangle">GdkRectangle</a> *area</code>);</pre>

583

584

Notify the input method that a change in cursor

585

position has been made. The location is relative to the client

604

605

<a name="gtk-im-context-set-use-preedit"></a><h3>gtk_im_context_set_use_preedit ()</h3>

606

<pre class="programlisting">void gtk_im_context_set_use_preedit (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

607

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> use_preedit</code>);</pre>

607

<code>gboolean use_preedit</code>);</pre>

608

609

Sets whether the IM context should use the preedit string

610

to display feedback. If <code>use_preedit</code> is FALSE (default

630

631

<a name="gtk-im-context-set-surrounding"></a><h3>gtk_im_context_set_surrounding ()</h3>

632

<pre class="programlisting">void gtk_im_context_set_surrounding (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

633

<code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *text</code>,

634

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> len</code>,

635

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> cursor_index</code>);</pre>

633

<code>const gchar *text</code>,

634

<code>gint len</code>,

635

<code>gint cursor_index</code>);</pre>

636

637

Sets surrounding context around the insertion point and preedit

638

string. This function is expected to be called in response to the

667

<hr>

668

669

<a name="gtk-im-context-get-surrounding"></a><h3>gtk_im_context_get_surrounding ()</h3>

670

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_im_context_get_surrounding (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

671

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> **text</code>,

672

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *cursor_index</code>);</pre>

670

<pre class="programlisting">gboolean gtk_im_context_get_surrounding (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

671

<code>gchar **text</code>,

672

<code>gint *cursor_index</code>);</pre>

673

674

Retrieves context around the insertion point. Input methods

675

typically want context in order to constrain input text based on

697

698

<td>location to store a UTF-8 encoded

699

string of text holding context around the insertion point.

700

If the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, then you must free the result

701

stored in this location with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

700

If the function returns <code class="literal">TRUE</code>, then you must free the result

701

stored in this location with <code class="function">g_free()</code>. [<acronym title="Parameter for returning results. Default is transfer full.">out</acronym>][<acronym title="Free data after the code is done.">transfer full</acronym>]

702

</td>

703

</tr>

704

<tr>

709

<tr>

710

<td>Returns :</td>

711

<td>

712

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if surrounding text was provided; in this case

712

<code class="literal">TRUE</code> if surrounding text was provided; in this case

713

you must free the result stored in *text.</td>

714

</tr>

715

</tbody>

718

<hr>

719

720

<a name="gtk-im-context-delete-surrounding"></a><h3>gtk_im_context_delete_surrounding ()</h3>

721

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_im_context_delete_surrounding (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

722

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> offset</code>,

723

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_chars</code>);</pre>

721

<pre class="programlisting">gboolean gtk_im_context_delete_surrounding (<code><a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context</code>,

722

<code>gint offset</code>,

723

<code>gint n_chars</code>);</pre>

724

725

Asks the widget that the input context is attached to to delete

726

characters around the cursor position by emitting the

761

<tr>

762

<td>Returns :</td>

763

<td>

764

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled.</td>

764

<code class="literal">TRUE</code> if the signal was handled.</td>

765

</tr>

766

</tbody>

767

</table></div>

772

773

<a name="GtkIMContext-commit"></a><h3>The <code class="literal">"commit"</code> signal</h3>

774

<pre class="programlisting">void user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

775

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> *str,

776

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

775

gchar *str,

776

gpointer user_data) : <code class="literal">Run Last</code></pre>

777

778

The ::commit signal is emitted when a complete input sequence

779

has been entered by the user. This can be a single character

800

<hr>

801

802

<a name="GtkIMContext-delete-surrounding"></a><h3>The <code class="literal">"delete-surrounding"</code> signal</h3>

803

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

804

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> offset,

805

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> n_chars,

806

803

<pre class="programlisting">gboolean user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

804

gint offset,

805

gint n_chars,

806

gpointer user_data) : <code class="literal">Run Last</code></pre>

807

808

The ::delete-surrounding signal is emitted when the input method

809

needs to delete all or part of the context surrounding the cursor.

832

<tr>

833

<td>Returns :</td>

834

<td>

835

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled.</td>

835

<code class="literal">TRUE</code> if the signal was handled.</td>

836

</tr>

837

</tbody>

838

</table></div>

841

842

<a name="GtkIMContext-preedit-changed"></a><h3>The <code class="literal">"preedit-changed"</code> signal</h3>

843

<pre class="programlisting">void user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

844

gpointer user_data) : <code class="literal">Run Last</code></pre>

845

846

The ::preedit-changed signal is emitted whenever the preedit sequence

847

currently being entered has changed. It is also emitted at the end of

866

867

<a name="GtkIMContext-preedit-end"></a><h3>The <code class="literal">"preedit-end"</code> signal</h3>

868

<pre class="programlisting">void user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

869

gpointer user_data) : <code class="literal">Run Last</code></pre>

870

871

The ::preedit-end signal is emitted when a preediting sequence

872

has been completed or canceled.

889

890

<a name="GtkIMContext-preedit-start"></a><h3>The <code class="literal">"preedit-start"</code> signal</h3>

891

<pre class="programlisting">void user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

892

gpointer user_data) : <code class="literal">Run Last</code></pre>

893

894

The ::preedit-start signal is emitted when a new preediting sequence

895

starts.

911

<hr>

912

913

<a name="GtkIMContext-retrieve-surrounding"></a><h3>The <code class="literal">"retrieve-surrounding"</code> signal</h3>

914

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

915

914

<pre class="programlisting">gboolean user_function (<a class="link" href="GtkIMContext.html" title="GtkIMContext">GtkIMContext</a> *context,

915

gpointer user_data) : <code class="literal">Run Last</code></pre>

916

917

The ::retrieve-surrounding signal is emitted when the input method

918

requires the context surrounding the cursor. The callback should set

933

<tr>

934

<td>Returns :</td>

935

<td>

936

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the signal was handled.</td>

936

<code class="literal">TRUE</code> if the signal was handled.</td>

937

</tr>

938

</tbody>

939

</table></div>

Older »