Gtk2::IMContext(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::IMContext — the whole vibe 💖

okay so bestie, this is Gtk2::IMContext(3), from the User Contributed Perl Documentation corner of the world. It's the Perl wrapper for GtkIMContext — that's the little guy that handles input methods, like when you're typing in Japanese or Korean or any of the input-method girlies and your keyboard needs to do a whole séance before the right character shows up. 🎀

No cap, this page is basically a list of methods and signals, so let's get into it. ✨

🌸 HIERARCHY 🌸

it's giving object-oriented royalty, and the family tree is real simple:

Glib::Object
+----Gtk2::IMContext

one parent, one baby. iconic. 👑

💅 METHODS 💅

okay so here's every method, and I'm not skipping a single one, because we don't do that here. 🫶

  • $context->set_client_window ($window) — hands over the client window. takes one arg:
    • $window (a Gtk2::Gdk::Window, or undef if you're feeling mysterious and windowless) 🦋
  • $context->set_cursor_location ($area) — tells the context where the cursor is chillin'. takes one arg:
    • $area (a Gtk2::Gdk::Rectangle) 🌸
  • boolean = $context->delete_surrounding ($offset, $n_chars) — returns a boolean, and it takes:
    • $offset (integer)
    • $n_chars (integer)
  • boolean = $context->filter_keypress ($key_event) — returns a boolean, and it takes:
    • $key_event (a Gtk2::Gdk::Event) ⌨️
  • $context->focus_in — no args, no drama, it just happens. main character energy. ✨
  • $context->focus_out — the exit, the outro, the closing credits. 💜
  • list = $context->get_preedit_string — no args, and you get a list back. 🍓
  • $context->reset — the literal factory reset of vibes. no args. 🔄
  • list = $context->get_surrounding — no args, returns a list. 🌈
  • $context->set_surrounding ($text, $cursor_index) — sets the surrounding text, takes:
    • $text (string)
    • $cursor_index (integer) 📍
  • $context->set_use_preedit ($use_preedit) — toggles the preedit situation, takes:
    • $use_preedit (boolean) ✅

🔥 SIGNALS 🔥

these are the signals it emits, and yes I'm listing all six because every single one matters:

  • commit — signature is (Gtk2::IMContext, string) 💫
  • boolean = delete-surrounding — signature is (Gtk2::IMContext, integer, integer) 😭
  • preedit-changed — signature is (Gtk2::IMContext) 🌸
  • preedit-end — signature is (Gtk2::IMContext) 🎀
  • preedit-start — signature is (Gtk2::IMContext) ✨
  • boolean = retrieve-surrounding — signature is (Gtk2::IMContext) 👑

🦋 SEE ALSO 🦋

if you wanna go deeper (iykyk), go check out:

  • Gtk2
  • Glib::Object

Copyright (C) 2003-2011 by the gtk2-perl team. 🫶

This software is licensed under the LGPL. See Gtk2 for a full notice. 📜

not me actually respecting the license terms, as one does 💅

and that's the whole page bestie!! this came to you from perl v5.42.0, dated 2025-07-25, and it's the Gtk2::IMContext(3) page — slay, ate, no crumbs left, periodt. 💖✨🎀

📦 where this page comes from