SDL_HINT_IME_IMPLEMENTED_UI(3)

💖 SDL_HINT_IME_IMPLEMENTED_UI 💖

okay bestie, welcome to the SDL3 FUNCTIONS corner of the manual, and today's main character is SDL_HINT_IME_IMPLEMENTED_UI — a variable that tells everyone what IME UI elements your app can actually show off. 🎀

---

✨ NAME ✨

SDL_HINT_IME_IMPLEMENTED_UI — a variable describing what IME UI elements the application can display. that's it, that's the vibe. 💅

---

🌸 SYNOPSIS 🌸

#include <SDL3/SDL_hints.h>

#define SDL_HINT_IME_IMPLEMENTED_UI "SDL_IME_IMPLEMENTED_UI"

---

🦋 DESCRIPTION 🦋

so here's the tea, bestie. by default, IME UI is handled using native components by the OS where possible. iconic behaviour, honestly. BUT — and this is the plot twist — that can interfere with stuff, or just straight-up not be visible when exclusive fullscreen mode is being used. 😭 the OS is out here doing its best and you literally cannot see it. tragic.

so you set this variable to a comma separated list containing the following items, and everybody knows what's up:

• "none" or "0" — the application can't render any IME elements, and native UI should be used. (default) — no cap, this is where you start.
• "composition" — the application handles SDL_EVENT_TEXT_EDITING events and can render the composition text. she's doing it herself, we love a self-sufficient queen. 👑
• "candidates" — the application handles SDL_EVENT_TEXT_EDITING_CANDIDATES and can render the candidate list. the dropdown? handled. periodt. 💅

⚠️ real talk: this hint should be set before SDL is initialized. set it early or it's not gonna hit, fr fr.

---

⭐ AVAILABILITY ⭐

this hint is available since SDL 3.2.0. been here since then and she ate every single time. 🔥

---

Simple Directmedia Layer 🌈 SDL 3.4.18 🌸 SDL_HINT_IME_IMPLEMENTED_UI(3) — mwah, that's the page, go forth and set your hints before init bestie, ily, bye! 🫶✨💖