Add WindowBase::setImePreEditPosition

include/SFML/Window/WindowBase.hpp

@@ -412,6 +412,23 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit popup
+    ///        should show up
+    ///
+    /// The position specified is relative to the left-top
+    /// corner of the window area.
+    ///
+    /// It is implementation-specific what happens when negative
+    /// values are used. X11 handles them as you would expect,
+    /// but Windows sometimes resets the position to the top-left
+    /// of the screen.
+    ///
+    /// \param position Left-top corner of the preedit popup
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position);
+
     ////////////////////////////////////////////////////////////
     /// \brief Get the OS-specific handle of the window
     ///

src/SFML/Window/Android/WindowImplAndroid.cpp

@@ -226,6 +226,13 @@ bool WindowImplAndroid::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowImplAndroid::setImePreEditPosition(const Vector2i& /* position */)
+{
+    // Not applicable
+}
+
+
 ////////////////////////////////////////////////////////////
 void WindowImplAndroid::forwardEvent(const Event& event)
 {

src/SFML/Window/Android/WindowImplAndroid.hpp

@@ -202,6 +202,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
     static void               forwardEvent(const Event& event);
     static WindowImplAndroid* singleInstance;
 

src/SFML/Window/CMakeLists.txt

@@ -330,7 +330,7 @@ if(SFML_OS_LINUX)
     find_package(UDev REQUIRED)
     target_link_libraries(sfml-window PRIVATE UDev::UDev dl)
 elseif(SFML_OS_WINDOWS)
-    target_link_libraries(sfml-window PRIVATE winmm gdi32)
+    target_link_libraries(sfml-window PRIVATE winmm gdi32 imm32)
 elseif(SFML_OS_FREEBSD)
     target_link_libraries(sfml-window PRIVATE usbhid)
 elseif(SFML_OS_MACOS)

src/SFML/Window/DRM/WindowImplDRM.cpp

@@ -158,6 +158,14 @@ bool WindowImplDRM::hasFocus() const
     return true;
 }
 
+
+////////////////////////////////////////////////////////////
+void WindowImplDRM::setImePreEditPosition(const Vector2i& /* position */)
+{
+    // Not applicable
+}
+
+
 void WindowImplDRM::processEvents()
 {
     sf::Event ev;

src/SFML/Window/DRM/WindowImplDRM.hpp

@@ -196,6 +196,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
 protected:
     ////////////////////////////////////////////////////////////
     /// \brief Process incoming events from the operating system

src/SFML/Window/Unix/WindowImplX11.cpp

@@ -1232,6 +1232,16 @@ bool WindowImplX11::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowImplX11::setImePreEditPosition(const Vector2i& position)
+{
+    const XPoint        xpos{static_cast<short>(position.x), static_cast<short>(position.y)};
+    const XVaNestedList preeditAttr = XVaCreateNestedList(0, XNSpotLocation, &xpos, NULL);
+    XSetICValues(m_inputContext, XNPreeditAttributes, preeditAttr, NULL);
+    XFree(preeditAttr);
+}
+
+
 ////////////////////////////////////////////////////////////
 void WindowImplX11::grabFocus()
 {

src/SFML/Window/Unix/WindowImplX11.hpp

@@ -203,6 +203,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
 protected:
     ////////////////////////////////////////////////////////////
     /// \brief Process incoming events from the operating system

src/SFML/Window/Win32/WindowImplWin32.cpp

@@ -454,6 +454,21 @@ bool WindowImplWin32::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowImplWin32::setImePreEditPosition(const Vector2i& position)
+{
+    if (HIMC himc = ImmGetContext(m_handle); himc != nullptr)
+    {
+        COMPOSITIONFORM cf;
+        cf.ptCurrentPos.x = static_cast<LONG>(position.x);
+        cf.ptCurrentPos.y = static_cast<LONG>(position.y);
+        cf.dwStyle        = CFS_FORCE_POSITION; // Don't let the IME adjust the position
+        ImmSetCompositionWindow(himc, &cf);
+        ImmReleaseContext(m_handle, himc);
+    }
+}
+
+
 ////////////////////////////////////////////////////////////
 void WindowImplWin32::registerWindowClass()
 {
@@ -671,7 +686,7 @@ Keyboard::Scancode WindowImplWin32::toScancode(WPARAM wParam, LPARAM lParam)
         case 86: return Keyboard::Scan::NonUsBackslash;
         case 87: return Keyboard::Scan::F11;
         case 88: return Keyboard::Scan::F12;
-    
+
         case 91: return (HIWORD(lParam) & KF_EXTENDED) ? Keyboard::Scan::LSystem : Keyboard::Scan::Unknown;
         case 92: return (HIWORD(lParam) & KF_EXTENDED) ? Keyboard::Scan::RSystem : Keyboard::Scan::Unknown;
         case 93: return (HIWORD(lParam) & KF_EXTENDED) ? Keyboard::Scan::Menu    : Keyboard::Scan::Unknown;

src/SFML/Window/Win32/WindowImplWin32.hpp

@@ -183,6 +183,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
 protected:
     ////////////////////////////////////////////////////////////
     /// \brief Process incoming events from the operating system

src/SFML/Window/WindowBase.cpp

@@ -351,6 +351,14 @@ bool WindowBase::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowBase::setImePreEditPosition(const Vector2i& position)
+{
+    if (m_impl)
+        m_impl->setImePreEditPosition(position);
+}
+
+
 ////////////////////////////////////////////////////////////
 WindowHandle WindowBase::getNativeHandle() const
 {

src/SFML/Window/WindowImpl.hpp

@@ -275,6 +275,15 @@ public:
     ////////////////////////////////////////////////////////////
     virtual bool hasFocus() const = 0;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    virtual void setImePreEditPosition(const Vector2i& position) = 0;
+
     ////////////////////////////////////////////////////////////
     /// \brief Create a Vulkan rendering surface
     ///

src/SFML/Window/iOS/WindowImplUIKit.hpp

@@ -197,6 +197,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
     ////////////////////////////////////////////////////////////
     /// \brief Notify an event
     ///

src/SFML/Window/iOS/WindowImplUIKit.mm

@@ -223,6 +223,13 @@ bool WindowImplUIKit::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowImplUIKit::setImePreEditPosition(const Vector2i& /* position */)
+{
+    // Not applicable
+}
+
+
 ////////////////////////////////////////////////////////////
 void WindowImplUIKit::forwardEvent(Event event)
 {

src/SFML/Window/macOS/WindowImplCocoa.hpp

@@ -371,6 +371,15 @@ public:
     ////////////////////////////////////////////////////////////
     bool hasFocus() const override;
 
+    ////////////////////////////////////////////////////////////
+    /// \brief Set the position where the IME preedit window
+    ///        should show up
+    ///
+    /// \param position Left-top corner of the preedit window
+    ///
+    ////////////////////////////////////////////////////////////
+    void setImePreEditPosition(const Vector2i& position) override;
+
 protected:
     ////////////////////////////////////////////////////////////
     /// \brief Process incoming events from the operating system

src/SFML/Window/macOS/WindowImplCocoa.mm

@@ -546,4 +546,11 @@ bool WindowImplCocoa::hasFocus() const
 }
 
 
+////////////////////////////////////////////////////////////
+void WindowImplCocoa::setImePreEditPosition(const Vector2i& /* position */)
+{
+    // TODO: To implement
+}
+
+
 } // namespace sf::priv