#include <flutter_window.h>

Inheritance diagram for flutter::FlutterWindow:

Public Member Functions
	FlutterWindow (int width, int height, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr, std::unique_ptr< TextInputManager > text_input_manager=nullptr)

virtual	~FlutterWindow ()

void	InitializeChild (const char *title, unsigned int width, unsigned int height)

virtual BOOL	Win32PeekMessage (LPMSG lpMsg, UINT wMsgFilterMin, UINT wMsgFilterMax, UINT wRemoveMsg) override

virtual uint32_t	Win32MapVkToChar (uint32_t virtual_key) override

virtual UINT	Win32DispatchMessage (UINT Msg, WPARAM wParam, LPARAM lParam) override

virtual void	OnDpiScale (unsigned int dpi)

virtual void	OnResize (unsigned int width, unsigned int height)

virtual void	OnPaint ()

virtual void	OnPointerMove (double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, int modifiers_state)

virtual void	OnPointerDown (double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, UINT button)

virtual void	OnPointerUp (double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, UINT button)

virtual void	OnPointerLeave (double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id)

virtual void	OnText (const std::u16string &text) override

virtual void	OnKey (int key, int scancode, int action, char32_t character, bool extended, bool was_down, KeyEventCallback callback) override

virtual void	OnComposeBegin ()

virtual void	OnComposeCommit ()

virtual void	OnComposeEnd ()

virtual void	OnComposeChange (const std::u16string &text, int cursor_pos)

virtual void	OnCursorRectUpdated (const Rect &rect) override

virtual void	OnResetImeComposing () override

virtual void	OnUpdateSemanticsEnabled (bool enabled)

virtual void	OnScroll (double delta_x, double delta_y, FlutterPointerDeviceKind device_kind, int32_t device_id)

virtual gfx::NativeViewAccessible	GetNativeViewAccessible ()

virtual void	SetView (WindowBindingHandlerDelegate *view) override

virtual HWND	GetWindowHandle () override

virtual float	GetDpiScale () override

virtual PhysicalWindowBounds	GetPhysicalWindowBounds () override

virtual bool	OnBitmapSurfaceCleared () override

virtual bool	OnBitmapSurfaceUpdated (const void *allocation, size_t row_bytes, size_t height) override

virtual PointerLocation	GetPrimaryPointerLocation () override

virtual void	OnThemeChange ()

virtual AlertPlatformNodeDelegate *	GetAlertDelegate () override

virtual ui::AXPlatformNodeWin *	GetAlert () override

virtual bool	Focus () override

virtual ui::AXFragmentRootDelegateWin *	GetAxFragmentRootDelegate ()

virtual void	OnWindowStateEvent (WindowStateEvent event)

Public Member Functions inherited from flutter::KeyboardManager::WindowDelegate
virtual	~WindowDelegate ()=default

Public Member Functions inherited from flutter::WindowBindingHandler
virtual	~WindowBindingHandler ()=default

Protected Member Functions
	FlutterWindow ()

virtual LRESULT	Win32DefWindowProc (HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam)

std::wstring	NarrowToWide (const char *source)

LRESULT	HandleMessage (UINT const message, WPARAM const wparam, LPARAM const lparam) noexcept

virtual LRESULT	OnGetObject (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	OnImeSetContext (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	OnImeStartComposition (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	OnImeComposition (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	OnImeEndComposition (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	OnImeRequest (UINT const message, WPARAM const wparam, LPARAM const lparam)

virtual void	AbortImeComposing ()

virtual void	UpdateCursorRect (const Rect &rect)

UINT	GetCurrentDPI ()

UINT	GetCurrentWidth ()

UINT	GetCurrentHeight ()

virtual float	GetScrollOffsetMultiplier ()

Protected Attributes
std::unique_ptr< AlertPlatformNodeDelegate >	alert_delegate_

std::unique_ptr< ui::AXPlatformNodeWin >	alert_node_

std::unique_ptr< DirectManipulationOwner >	direct_manipulation_owner_

Friends
class	WindowAXFragmentRootDelegate

Additional Inherited Members
Public Types inherited from flutter::KeyboardManager::WindowDelegate
using	KeyEventCallback = std::function< void(bool)>

Detailed Description

Definition at line 35 of file flutter_window.h.

Constructor & Destructor Documentation

◆ FlutterWindow() [1/2]

flutter::FlutterWindow::FlutterWindow	(	int	width,
		int	height,
		std::shared_ptr< WindowsProcTable >	windows_proc_table = `nullptr`,
		std::unique_ptr< TextInputManager >	text_input_manager = `nullptr`
	)

Definition at line 76 of file flutter_window.cc.

     : touch_id_generator_(kMinTouchDeviceId, kMaxTouchDeviceId),
       windows_proc_table_(std::move(windows_proc_table)),
       text_input_manager_(std::move(text_input_manager)),
       ax_fragment_root_(nullptr) {
   // Get the DPI of the primary monitor as the initial DPI. If Per-Monitor V2 is
   // supported, |current_dpi_| should be updated in the
   // kWmDpiChangedBeforeParent message.
   current_dpi_ = GetDpiForHWND(nullptr);
  
   // Get initial value for wheel scroll lines
   // TODO: Listen to changes for this value
   // https://github.com/flutter/flutter/issues/107248
   UpdateScrollOffsetMultiplier();
  
   if (windows_proc_table_ == nullptr) {
     windows_proc_table_ = std::make_unique<WindowsProcTable>();
   }
   if (text_input_manager_ == nullptr) {
     text_input_manager_ = std::make_unique<TextInputManager>();
   }
   keyboard_manager_ = std::make_unique<KeyboardManager>(this);
  
   InitializeChild("FLUTTERVIEW", width, height);
 }

References flutter::GetDpiForHWND(), and InitializeChild().

◆ ~FlutterWindow()

flutter::FlutterWindow::~FlutterWindow ( )

virtual

Definition at line 110 of file flutter_window.cc.

                               {
   Destroy();
 }

◆ FlutterWindow() [2/2]

flutter::FlutterWindow::FlutterWindow ( )

protected

Definition at line 107 of file flutter_window.cc.

108 : touch_id_generator_(kMinTouchDeviceId, kMaxTouchDeviceId) {}

Member Function Documentation

◆ AbortImeComposing()

void flutter::FlutterWindow::AbortImeComposing ( )

protectedvirtual

Definition at line 873 of file flutter_window.cc.

                                       {
   text_input_manager_->AbortComposing();
 }

Referenced by OnResetImeComposing().

◆ Focus()

bool flutter::FlutterWindow::Focus ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 135 of file flutter_window.cc.

                           {
   auto hwnd = GetWindowHandle();
   if (hwnd == nullptr) {
     return false;
   }
  
   HWND prevFocus = ::SetFocus(hwnd);
   if (prevFocus == nullptr) {
     return false;
   }
  
   return true;
 }

References GetWindowHandle().

◆ GetAlert()

ui::AXPlatformNodeWin * flutter::FlutterWindow::GetAlert ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 321 of file flutter_window.cc.

                                              {
   CreateAxFragmentRoot();
   return alert_node_.get();
 }

References alert_node_.

◆ GetAlertDelegate()

AlertPlatformNodeDelegate * flutter::FlutterWindow::GetAlertDelegate ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 316 of file flutter_window.cc.

                                                            {
   CreateAxFragmentRoot();
   return alert_delegate_.get();
 }

References alert_delegate_.

◆ GetAxFragmentRootDelegate()

ui::AXFragmentRootDelegateWin * flutter::FlutterWindow::GetAxFragmentRootDelegate ( )

virtual

Definition at line 312 of file flutter_window.cc.

                                                                       {
   return binding_handler_delegate_->GetAxFragmentRootDelegate();
 }

References flutter::WindowBindingHandlerDelegate::GetAxFragmentRootDelegate().

◆ GetCurrentDPI()

UINT flutter::FlutterWindow::GetCurrentDPI ( )

protected

Definition at line 881 of file flutter_window.cc.

                                   {
   return current_dpi_;
 }

Referenced by GetDpiScale().

◆ GetCurrentHeight()

UINT flutter::FlutterWindow::GetCurrentHeight ( )

protected

Definition at line 889 of file flutter_window.cc.

                                      {
   return current_height_;
 }

Referenced by GetPhysicalWindowBounds().

◆ GetCurrentWidth()

UINT flutter::FlutterWindow::GetCurrentWidth ( )

protected

Definition at line 885 of file flutter_window.cc.

                                     {
   return current_width_;
 }

Referenced by GetPhysicalWindowBounds().

◆ GetDpiScale()

float flutter::FlutterWindow::GetDpiScale ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 127 of file flutter_window.cc.

                                  {
   return static_cast<float>(GetCurrentDPI()) / static_cast<float>(base_dpi);
 }

References GetCurrentDPI().

Referenced by OnCursorRectUpdated().

◆ GetNativeViewAccessible()

gfx::NativeViewAccessible flutter::FlutterWindow::GetNativeViewAccessible ( )

virtual

Definition at line 293 of file flutter_window.cc.

                                                                {
   if (binding_handler_delegate_ == nullptr) {
     return nullptr;
   }
  
   return binding_handler_delegate_->GetNativeViewAccessible();
 }

References flutter::WindowBindingHandlerDelegate::GetNativeViewAccessible().

Referenced by OnGetObject().

◆ GetPhysicalWindowBounds()

PhysicalWindowBounds flutter::FlutterWindow::GetPhysicalWindowBounds ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 131 of file flutter_window.cc.

                                                             {
   return {GetCurrentWidth(), GetCurrentHeight()};
 }

References GetCurrentHeight(), and GetCurrentWidth().

◆ GetPrimaryPointerLocation()

PointerLocation flutter::FlutterWindow::GetPrimaryPointerLocation ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 301 of file flutter_window.cc.

                                                          {
   POINT point;
   GetCursorPos(&point);
   ScreenToClient(GetWindowHandle(), &point);
   return {(size_t)point.x, (size_t)point.y};
 }

References GetWindowHandle().

◆ GetScrollOffsetMultiplier()

float flutter::FlutterWindow::GetScrollOffsetMultiplier ( )

protectedvirtual

Definition at line 893 of file flutter_window.cc.

                                                {
   return scroll_offset_multiplier_;
 }

Referenced by OnScroll().

◆ GetWindowHandle()

HWND flutter::FlutterWindow::GetWindowHandle ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 430 of file flutter_window.cc.

                                     {
   return window_handle_;
 }

Referenced by flutter::DirectManipulationOwner::Destroy(), Focus(), GetPrimaryPointerLocation(), flutter::DirectManipulationOwner::Init(), OnBitmapSurfaceCleared(), OnBitmapSurfaceUpdated(), OnScroll(), and OnWindowStateEvent().

◆ HandleMessage()

LRESULT flutter::FlutterWindow::HandleMessage	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectednoexcept

Definition at line 499 of file flutter_window.cc.

                                                            {
   LPARAM result_lparam = lparam;
   int xPos = 0, yPos = 0;
   UINT width = 0, height = 0;
   UINT button_pressed = 0;
   FlutterPointerDeviceKind device_kind;
  
   switch (message) {
     case kWmDpiChangedBeforeParent:
       current_dpi_ = GetDpiForHWND(window_handle_);
       OnDpiScale(current_dpi_);
       return 0;
     case WM_SIZE:
       width = LOWORD(lparam);
       height = HIWORD(lparam);
  
       current_width_ = width;
       current_height_ = height;
       HandleResize(width, height);
  
       OnWindowStateEvent(width == 0 && height == 0 ? WindowStateEvent::kHide
                                                    : WindowStateEvent::kShow);
       break;
     case WM_PAINT:
       OnPaint();
       break;
     case WM_TOUCH: {
       UINT num_points = LOWORD(wparam);
       touch_points_.resize(num_points);
       auto touch_input_handle = reinterpret_cast<HTOUCHINPUT>(lparam);
       if (GetTouchInputInfo(touch_input_handle, num_points,
                             touch_points_.data(), sizeof(TOUCHINPUT))) {
         for (const auto& touch : touch_points_) {
           // Generate a mapped ID for the Windows-provided touch ID
           auto touch_id = touch_id_generator_.GetGeneratedId(touch.dwID);
  
           POINT pt = {TOUCH_COORD_TO_PIXEL(touch.x),
                       TOUCH_COORD_TO_PIXEL(touch.y)};
           ScreenToClient(window_handle_, &pt);
           auto x = static_cast<double>(pt.x);
           auto y = static_cast<double>(pt.y);
  
           if (touch.dwFlags & TOUCHEVENTF_DOWN) {
             OnPointerDown(x, y, kFlutterPointerDeviceKindTouch, touch_id,
                           WM_LBUTTONDOWN);
           } else if (touch.dwFlags & TOUCHEVENTF_MOVE) {
             OnPointerMove(x, y, kFlutterPointerDeviceKindTouch, touch_id, 0);
           } else if (touch.dwFlags & TOUCHEVENTF_UP) {
             OnPointerUp(x, y, kFlutterPointerDeviceKindTouch, touch_id,
                         WM_LBUTTONDOWN);
             OnPointerLeave(x, y, kFlutterPointerDeviceKindTouch, touch_id);
             touch_id_generator_.ReleaseNumber(touch.dwID);
           }
         }
         CloseTouchInputHandle(touch_input_handle);
       }
       return 0;
     }
     case WM_MOUSEMOVE:
       device_kind = GetFlutterPointerDeviceKind();
       if (device_kind == kFlutterPointerDeviceKindMouse) {
         TrackMouseLeaveEvent(window_handle_);
  
         xPos = GET_X_LPARAM(lparam);
         yPos = GET_Y_LPARAM(lparam);
         mouse_x_ = static_cast<double>(xPos);
         mouse_y_ = static_cast<double>(yPos);
  
         int mods = 0;
         if (wparam & MK_CONTROL) {
           mods |= kControl;
         }
         if (wparam & MK_SHIFT) {
           mods |= kShift;
         }
         OnPointerMove(mouse_x_, mouse_y_, device_kind, kDefaultPointerDeviceId,
                       mods);
       }
       break;
     case WM_MOUSELEAVE:
       device_kind = GetFlutterPointerDeviceKind();
       if (device_kind == kFlutterPointerDeviceKindMouse) {
         OnPointerLeave(mouse_x_, mouse_y_, device_kind,
                        kDefaultPointerDeviceId);
       }
  
       // Once the tracked event is received, the TrackMouseEvent function
       // resets. Set to false to make sure it's called once mouse movement is
       // detected again.
       tracking_mouse_leave_ = false;
       break;
     case WM_SETCURSOR: {
       UINT hit_test_result = LOWORD(lparam);
       if (hit_test_result == HTCLIENT) {
         // Halt further processing to prevent DefWindowProc from setting the
         // cursor back to the registered class cursor.
         return TRUE;
       }
       break;
     }
     case WM_SETFOCUS:
       OnWindowStateEvent(WindowStateEvent::kFocus);
       ::CreateCaret(window_handle_, nullptr, 1, 1);
       break;
     case WM_KILLFOCUS:
       OnWindowStateEvent(WindowStateEvent::kUnfocus);
       ::DestroyCaret();
       break;
     case WM_LBUTTONDOWN:
     case WM_RBUTTONDOWN:
     case WM_MBUTTONDOWN:
     case WM_XBUTTONDOWN:
       device_kind = GetFlutterPointerDeviceKind();
       if (device_kind != kFlutterPointerDeviceKindMouse) {
         break;
       }
  
       if (message == WM_LBUTTONDOWN) {
         // Capture the pointer in case the user drags outside the client area.
         // In this case, the "mouse leave" event is delayed until the user
         // releases the button. It's only activated on left click given that
         // it's more common for apps to handle dragging with only the left
         // button.
         SetCapture(window_handle_);
       }
       button_pressed = message;
       if (message == WM_XBUTTONDOWN) {
         button_pressed = GET_XBUTTON_WPARAM(wparam);
       }
       xPos = GET_X_LPARAM(lparam);
       yPos = GET_Y_LPARAM(lparam);
       OnPointerDown(static_cast<double>(xPos), static_cast<double>(yPos),
                     device_kind, kDefaultPointerDeviceId, button_pressed);
       break;
     case WM_LBUTTONUP:
     case WM_RBUTTONUP:
     case WM_MBUTTONUP:
     case WM_XBUTTONUP:
       device_kind = GetFlutterPointerDeviceKind();
       if (device_kind != kFlutterPointerDeviceKindMouse) {
         break;
       }
  
       if (message == WM_LBUTTONUP) {
         ReleaseCapture();
       }
       button_pressed = message;
       if (message == WM_XBUTTONUP) {
         button_pressed = GET_XBUTTON_WPARAM(wparam);
       }
       xPos = GET_X_LPARAM(lparam);
       yPos = GET_Y_LPARAM(lparam);
       OnPointerUp(static_cast<double>(xPos), static_cast<double>(yPos),
                   device_kind, kDefaultPointerDeviceId, button_pressed);
       break;
     case WM_MOUSEWHEEL:
       OnScroll(0.0,
                -(static_cast<short>(HIWORD(wparam)) /
                  static_cast<double>(WHEEL_DELTA)),
                kFlutterPointerDeviceKindMouse, kDefaultPointerDeviceId);
       break;
     case WM_MOUSEHWHEEL:
       OnScroll((static_cast<short>(HIWORD(wparam)) /
                 static_cast<double>(WHEEL_DELTA)),
                0.0, kFlutterPointerDeviceKindMouse, kDefaultPointerDeviceId);
       break;
     case WM_GETOBJECT: {
       LRESULT lresult = OnGetObject(message, wparam, lparam);
       if (lresult) {
         return lresult;
       }
       break;
     }
     case WM_TIMER:
       if (wparam == kDirectManipulationTimer) {
         direct_manipulation_owner_->Update();
         return 0;
       }
       break;
     case DM_POINTERHITTEST: {
       if (direct_manipulation_owner_) {
         UINT contact_id = GET_POINTERID_WPARAM(wparam);
         POINTER_INPUT_TYPE pointer_type;
         if (windows_proc_table_->GetPointerType(contact_id, &pointer_type) &&
             pointer_type == PT_TOUCHPAD) {
           direct_manipulation_owner_->SetContact(contact_id);
         }
       }
       break;
     }
     case WM_INPUTLANGCHANGE:
       // TODO(cbracken): pass this to TextInputManager to aid with
       // language-specific issues.
       break;
     case WM_IME_SETCONTEXT:
       OnImeSetContext(message, wparam, lparam);
       // Strip the ISC_SHOWUICOMPOSITIONWINDOW bit from lparam before passing it
       // to DefWindowProc() so that the composition window is hidden since
       // Flutter renders the composing string itself.
       result_lparam &= ~ISC_SHOWUICOMPOSITIONWINDOW;
       break;
     case WM_IME_STARTCOMPOSITION:
       OnImeStartComposition(message, wparam, lparam);
       // Suppress further processing by DefWindowProc() so that the default
       // system IME style isn't used, but rather the one set in the
       // WM_IME_SETCONTEXT handler.
       return TRUE;
     case WM_IME_COMPOSITION:
       OnImeComposition(message, wparam, lparam);
       if (lparam & GCS_RESULTSTR || lparam & GCS_COMPSTR) {
         // Suppress further processing by DefWindowProc() since otherwise it
         // will emit the result string as WM_CHAR messages on commit. Instead,
         // committing the composing text to the EditableText string is handled
         // in TextInputModel::CommitComposing, triggered by
         // OnImeEndComposition().
         return TRUE;
       }
       break;
     case WM_IME_ENDCOMPOSITION:
       OnImeEndComposition(message, wparam, lparam);
       return TRUE;
     case WM_IME_REQUEST:
       OnImeRequest(message, wparam, lparam);
       break;
     case WM_UNICHAR: {
       // Tell third-pary app, we can support Unicode.
       if (wparam == UNICODE_NOCHAR)
         return TRUE;
       // DefWindowProc will send WM_CHAR for this WM_UNICHAR.
       break;
     }
     case WM_THEMECHANGED:
       OnThemeChange();
       break;
     case WM_DEADCHAR:
     case WM_SYSDEADCHAR:
     case WM_CHAR:
     case WM_SYSCHAR:
     case WM_KEYDOWN:
     case WM_SYSKEYDOWN:
     case WM_KEYUP:
     case WM_SYSKEYUP:
       if (keyboard_manager_->HandleMessage(message, wparam, lparam)) {
         return 0;
       }
       break;
   }
  
   return Win32DefWindowProc(window_handle_, message, wparam, result_lparam);
 }

References flutter::GetDpiForHWND(), flutter::kControl, flutter::kFocus, flutter::kHide, flutter::kShift, flutter::kShow, flutter::kUnfocus, and message.

◆ InitializeChild()

void flutter::FlutterWindow::InitializeChild	(	const char *	title,
		unsigned int	width,
		unsigned int	height
	)

Definition at line 395 of file flutter_window.cc.

                                                          {
   Destroy();
   std::wstring converted_title = NarrowToWide(title);
  
   WNDCLASS window_class = RegisterWindowClass(converted_title);
  
   auto* result = CreateWindowEx(
       0, window_class.lpszClassName, converted_title.c_str(),
       WS_CHILD | WS_VISIBLE, CW_DEFAULT, CW_DEFAULT, width, height,
       HWND_MESSAGE, nullptr, window_class.hInstance, this);
  
   if (result == nullptr) {
     auto error = GetLastError();
     LPWSTR message = nullptr;
     size_t size = FormatMessageW(
         FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
             FORMAT_MESSAGE_IGNORE_INSERTS,
         NULL, error, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
         reinterpret_cast<LPWSTR>(&message), 0, NULL);
     OutputDebugString(message);
     LocalFree(message);
   }
   SetUserObjectInformationA(GetCurrentProcess(),
                             UOI_TIMERPROC_EXCEPTION_SUPPRESSION, FALSE, 1);
   // SetTimer is not precise, if a 16 ms interval is requested, it will instead
   // often fire in an interval of 32 ms. Providing a value of 14 will ensure it
   // runs every 16 ms, which will allow for 60 Hz trackpad gesture events, which
   // is the maximal frequency supported by SetTimer.
   SetTimer(result, kDirectManipulationTimer, 14, nullptr);
   direct_manipulation_owner_ = std::make_unique<DirectManipulationOwner>(this);
   direct_manipulation_owner_->Init(width, height);
 }

References direct_manipulation_owner_, message, and NarrowToWide().

Referenced by FlutterWindow().

◆ NarrowToWide()

std::wstring flutter::FlutterWindow::NarrowToWide ( const char * source )

protected

Definition at line 452 of file flutter_window.cc.

                                                          {
   size_t length = strlen(source);
   size_t outlen = 0;
   std::wstring wideTitle(length, L'#');
   mbstowcs_s(&outlen, &wideTitle[0], length + 1, source, length);
   return wideTitle;
 }

Referenced by InitializeChild().

◆ OnBitmapSurfaceCleared()

bool flutter::FlutterWindow::OnBitmapSurfaceCleared ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 268 of file flutter_window.cc.

                                            {
   HDC dc = ::GetDC(GetWindowHandle());
   bool result = ::PatBlt(dc, 0, 0, current_width_, current_height_, BLACKNESS);
   ::ReleaseDC(GetWindowHandle(), dc);
   return result;
 }

References GetWindowHandle().

◆ OnBitmapSurfaceUpdated()

bool flutter::FlutterWindow::OnBitmapSurfaceUpdated	(	const void *	allocation,
		size_t	row_bytes,
		size_t	height
	)

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 275 of file flutter_window.cc.

                                                           {
   HDC dc = ::GetDC(GetWindowHandle());
   BITMAPINFO bmi = {};
   bmi.bmiHeader.biSize = sizeof(BITMAPINFOHEADER);
   bmi.bmiHeader.biWidth = row_bytes / 4;
   bmi.bmiHeader.biHeight = -height;
   bmi.bmiHeader.biPlanes = 1;
   bmi.bmiHeader.biBitCount = 32;
   bmi.bmiHeader.biCompression = BI_RGB;
   bmi.bmiHeader.biSizeImage = 0;
   int ret = ::SetDIBitsToDevice(dc, 0, 0, row_bytes / 4, height, 0, 0, 0,
                                 height, allocation, &bmi, DIB_RGB_COLORS);
   ::ReleaseDC(GetWindowHandle(), dc);
   return ret != 0;
 }

References GetWindowHandle().

Referenced by flutter::testing::TEST_F().

◆ OnComposeBegin()

void flutter::FlutterWindow::OnComposeBegin ( )

virtual

Definition at line 222 of file flutter_window.cc.

                                    {
   binding_handler_delegate_->OnComposeBegin();
 }

References flutter::WindowBindingHandlerDelegate::OnComposeBegin().

Referenced by OnImeStartComposition().

◆ OnComposeChange()

void flutter::FlutterWindow::OnComposeChange	(	const std::u16string &	text,
		int	cursor_pos
	)

virtual

Definition at line 234 of file flutter_window.cc.

                                                     {
   binding_handler_delegate_->OnComposeChange(text, cursor_pos);
 }

References flutter::WindowBindingHandlerDelegate::OnComposeChange(), and text.

Referenced by OnImeComposition().

◆ OnComposeCommit()

void flutter::FlutterWindow::OnComposeCommit ( )

virtual

Definition at line 226 of file flutter_window.cc.

                                     {
   binding_handler_delegate_->OnComposeCommit();
 }

References flutter::WindowBindingHandlerDelegate::OnComposeCommit().

Referenced by OnImeComposition().

◆ OnComposeEnd()

void flutter::FlutterWindow::OnComposeEnd ( )

virtual

Definition at line 230 of file flutter_window.cc.

                                  {
   binding_handler_delegate_->OnComposeEnd();
 }

References flutter::WindowBindingHandlerDelegate::OnComposeEnd().

Referenced by OnImeEndComposition().

◆ OnCursorRectUpdated()

void flutter::FlutterWindow::OnCursorRectUpdated ( const Rect & rect )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 256 of file flutter_window.cc.

                                                         {
   // Convert the rect from Flutter logical coordinates to device coordinates.
   auto scale = GetDpiScale();
   Point origin(rect.left() * scale, rect.top() * scale);
   Size size(rect.width() * scale, rect.height() * scale);
   UpdateCursorRect(Rect(origin, size));
 }

References GetDpiScale(), flutter::Rect::height(), flutter::Rect::left(), flutter::Rect::top(), UpdateCursorRect(), and flutter::Rect::width().

◆ OnDpiScale()

void flutter::FlutterWindow::OnDpiScale ( unsigned int dpi )

virtual

Definition at line 149 of file flutter_window.cc.

149 {};

◆ OnGetObject()

LRESULT flutter::FlutterWindow::OnGetObject	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 752 of file flutter_window.cc.

                                                         {
   LRESULT reference_result = static_cast<LRESULT>(0L);
  
   // Only the lower 32 bits of lparam are valid when checking the object id
   // because it sometimes gets sign-extended incorrectly (but not always).
   DWORD obj_id = static_cast<DWORD>(static_cast<DWORD_PTR>(lparam));
  
   bool is_uia_request = static_cast<DWORD>(UiaRootObjectId) == obj_id;
   bool is_msaa_request = static_cast<DWORD>(OBJID_CLIENT) == obj_id;
  
   if (is_uia_request || is_msaa_request) {
     // On Windows, we don't get a notification that the screen reader has been
     // enabled or disabled. There is an API to query for screen reader state,
     // but that state isn't set by all screen readers, including by Narrator,
     // the screen reader that ships with Windows:
     // https://docs.microsoft.com/en-us/windows/win32/winauto/screen-reader-parameter
     //
     // Instead, we enable semantics in Flutter if Windows issues queries for
     // Microsoft Active Accessibility (MSAA) COM objects.
     OnUpdateSemanticsEnabled(true);
   }
  
   gfx::NativeViewAccessible root_view = GetNativeViewAccessible();
   // TODO(schectman): UIA is currently disabled by default.
   // https://github.com/flutter/flutter/issues/114547
   if (root_view) {
     CreateAxFragmentRoot();
     if (is_uia_request) {
 #ifdef FLUTTER_ENGINE_USE_UIA
       // Retrieve UIA object for the root view.
       Microsoft::WRL::ComPtr<IRawElementProviderSimple> root;
       if (SUCCEEDED(
               ax_fragment_root_->GetNativeViewAccessible()->QueryInterface(
                   IID_PPV_ARGS(&root)))) {
         // Return the UIA object via UiaReturnRawElementProvider(). See:
         // https://docs.microsoft.com/en-us/windows/win32/winauto/wm-getobject
         reference_result = UiaReturnRawElementProvider(window_handle_, wparam,
                                                        lparam, root.Get());
       } else {
         FML_LOG(ERROR) << "Failed to query AX fragment root.";
       }
 #endif  // FLUTTER_ENGINE_USE_UIA
     } else if (is_msaa_request) {
       // Create the accessibility root if it does not already exist.
       // Return the IAccessible for the root view.
       Microsoft::WRL::ComPtr<IAccessible> root;
       ax_fragment_root_->GetNativeViewAccessible()->QueryInterface(
           IID_PPV_ARGS(&root));
       reference_result = LresultFromObject(IID_IAccessible, wparam, root.Get());
     }
   }
   return reference_result;
 }

References GetNativeViewAccessible(), and OnUpdateSemanticsEnabled().

◆ OnImeComposition()

void flutter::FlutterWindow::OnImeComposition	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 823 of file flutter_window.cc.

                                                           {
   // Update the IME window position.
   text_input_manager_->UpdateImeWindow();
  
   if (lparam == 0) {
     OnComposeChange(u"", 0);
     OnComposeCommit();
   }
  
   // Process GCS_RESULTSTR at fisrt, because Google Japanese Input and ATOK send
   // both GCS_RESULTSTR and GCS_COMPSTR to commit composed text and send new
   // composing text.
   if (lparam & GCS_RESULTSTR) {
     // Commit but don't end composing.
     // Read the committed composing string.
     long pos = text_input_manager_->GetComposingCursorPosition();
     std::optional<std::u16string> text = text_input_manager_->GetResultString();
     if (text) {
       OnComposeChange(text.value(), pos);
       OnComposeCommit();
     }
   }
   if (lparam & GCS_COMPSTR) {
     // Read the in-progress composing string.
     long pos = text_input_manager_->GetComposingCursorPosition();
     std::optional<std::u16string> text =
         text_input_manager_->GetComposingString();
     if (text) {
       OnComposeChange(text.value(), pos);
     }
   }
 }

References OnComposeChange(), OnComposeCommit(), and text.

◆ OnImeEndComposition()

void flutter::FlutterWindow::OnImeEndComposition	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 858 of file flutter_window.cc.

                                                              {
   text_input_manager_->DestroyImeWindow();
   OnComposeEnd();
 }

References OnComposeEnd().

◆ OnImeRequest()

void flutter::FlutterWindow::OnImeRequest	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 865 of file flutter_window.cc.

                                                       {
   // TODO(cbracken): Handle IMR_RECONVERTSTRING, IMR_DOCUMENTFEED,
   // and IMR_QUERYCHARPOSITION messages.
   // https://github.com/flutter/flutter/issues/74547
 }

◆ OnImeSetContext()

void flutter::FlutterWindow::OnImeSetContext	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 808 of file flutter_window.cc.

                                                          {
   if (wparam != 0) {
     text_input_manager_->CreateImeWindow();
   }
 }

◆ OnImeStartComposition()

void flutter::FlutterWindow::OnImeStartComposition	(	UINT const	message,
		WPARAM const	wparam,
		LPARAM const	lparam
	)

protectedvirtual

Definition at line 816 of file flutter_window.cc.

                                                                {
   text_input_manager_->CreateImeWindow();
   OnComposeBegin();
 }

References OnComposeBegin().

◆ OnKey()

void flutter::FlutterWindow::OnKey	(	int	key,
		int	scancode,
		int	action,
		char32_t	character,
		bool	extended,
		bool	was_down,
		KeyEventCallback	callback
	)

overridevirtual

Implements flutter::KeyboardManager::WindowDelegate.

Definition at line 211 of file flutter_window.cc.

                                                      {
   binding_handler_delegate_->OnKey(key, scancode, action, character, extended,
                                    was_down, std::move(callback));
 }

References action, callback, character, extended, key, flutter::WindowBindingHandlerDelegate::OnKey(), scancode, and was_down.

◆ OnPaint()

void flutter::FlutterWindow::OnPaint ( )

virtual

Definition at line 159 of file flutter_window.cc.

                             {
   if (binding_handler_delegate_ != nullptr) {
     binding_handler_delegate_->OnWindowRepaint();
   }
 }

References flutter::WindowBindingHandlerDelegate::OnWindowRepaint().

◆ OnPointerDown()

void flutter::FlutterWindow::OnPointerDown	(	double	x,
		double	y,
		FlutterPointerDeviceKind	device_kind,
		int32_t	device_id,
		UINT	button
	)

virtual

Definition at line 174 of file flutter_window.cc.

                                                {
   uint64_t flutter_button = ConvertWinButtonToFlutterButton(button);
   if (flutter_button != 0) {
     binding_handler_delegate_->OnPointerDown(
         x, y, device_kind, device_id,
         static_cast<FlutterPointerMouseButtons>(flutter_button));
   }
 }

References flutter::WindowBindingHandlerDelegate::OnPointerDown().

Referenced by flutter::testing::TEST_F().

◆ OnPointerLeave()

void flutter::FlutterWindow::OnPointerLeave	(	double	x,
		double	y,
		FlutterPointerDeviceKind	device_kind,
		int32_t	device_id
	)

virtual

Definition at line 200 of file flutter_window.cc.

                                                       {
   binding_handler_delegate_->OnPointerLeave(x, y, device_kind, device_id);
 }

References flutter::WindowBindingHandlerDelegate::OnPointerLeave().

Referenced by flutter::testing::TEST_F().

◆ OnPointerMove()

void flutter::FlutterWindow::OnPointerMove	(	double	x,
		double	y,
		FlutterPointerDeviceKind	device_kind,
		int32_t	device_id,
		int	modifiers_state
	)

virtual

Definition at line 165 of file flutter_window.cc.

                                                        {
   binding_handler_delegate_->OnPointerMove(x, y, device_kind, device_id,
                                            modifiers_state);
 }

References flutter::WindowBindingHandlerDelegate::OnPointerMove().

Referenced by flutter::testing::TEST_F().

◆ OnPointerUp()

void flutter::FlutterWindow::OnPointerUp	(	double	x,
		double	y,
		FlutterPointerDeviceKind	device_kind,
		int32_t	device_id,
		UINT	button
	)

virtual

Definition at line 187 of file flutter_window.cc.

                                              {
   uint64_t flutter_button = ConvertWinButtonToFlutterButton(button);
   if (flutter_button != 0) {
     binding_handler_delegate_->OnPointerUp(
         x, y, device_kind, device_id,
         static_cast<FlutterPointerMouseButtons>(flutter_button));
   }
 }

References flutter::WindowBindingHandlerDelegate::OnPointerUp().

Referenced by flutter::testing::TEST_F().

◆ OnResetImeComposing()

void flutter::FlutterWindow::OnResetImeComposing ( )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 264 of file flutter_window.cc.

                                         {
   AbortImeComposing();
 }

References AbortImeComposing().

◆ OnResize()

void flutter::FlutterWindow::OnResize	(	unsigned int	width,
		unsigned int	height
	)

virtual

Definition at line 153 of file flutter_window.cc.

                                                                     {
   if (binding_handler_delegate_ != nullptr) {
     binding_handler_delegate_->OnWindowSizeChanged(width, height);
   }
 }

References flutter::WindowBindingHandlerDelegate::OnWindowSizeChanged().

◆ OnScroll()

void flutter::FlutterWindow::OnScroll	(	double	delta_x,
		double	delta_y,
		FlutterPointerDeviceKind	device_kind,
		int32_t	device_id
	)

virtual

Definition at line 243 of file flutter_window.cc.

                                                 {
   POINT point;
   GetCursorPos(&point);
  
   ScreenToClient(GetWindowHandle(), &point);
   binding_handler_delegate_->OnScroll(point.x, point.y, delta_x, delta_y,
                                       GetScrollOffsetMultiplier(), device_kind,
                                       device_id);
 }

References GetScrollOffsetMultiplier(), GetWindowHandle(), and flutter::WindowBindingHandlerDelegate::OnScroll().

◆ OnText()

void flutter::FlutterWindow::OnText ( const std::u16string & text )

overridevirtual

Implements flutter::KeyboardManager::WindowDelegate.

Definition at line 207 of file flutter_window.cc.

                                                    {
   binding_handler_delegate_->OnText(text);
 }

References flutter::WindowBindingHandlerDelegate::OnText(), and text.

◆ OnThemeChange()

void flutter::FlutterWindow::OnThemeChange ( )

virtual

Definition at line 308 of file flutter_window.cc.

                                   {
   binding_handler_delegate_->OnHighContrastChanged();
 }

References flutter::WindowBindingHandlerDelegate::OnHighContrastChanged().

◆ OnUpdateSemanticsEnabled()

void flutter::FlutterWindow::OnUpdateSemanticsEnabled ( bool enabled )

virtual

Definition at line 239 of file flutter_window.cc.

                                                          {
   binding_handler_delegate_->OnUpdateSemanticsEnabled(enabled);
 }

References flutter::WindowBindingHandlerDelegate::OnUpdateSemanticsEnabled().

Referenced by OnGetObject().

◆ OnWindowStateEvent()

void flutter::FlutterWindow::OnWindowStateEvent ( WindowStateEvent event )

virtual

Definition at line 326 of file flutter_window.cc.

                                                              {
   switch (event) {
     case WindowStateEvent::kShow:
       restored_ = true;
       break;
     case WindowStateEvent::kHide:
       restored_ = false;
       focused_ = false;
       break;
     case WindowStateEvent::kFocus:
       focused_ = true;
       if (binding_handler_delegate_) {
         binding_handler_delegate_->OnFocus(
             FlutterViewFocusState::kFocused,
             FlutterViewFocusDirection::kUndefined);
       }
       break;
     case WindowStateEvent::kUnfocus:
       focused_ = false;
       if (binding_handler_delegate_) {
         binding_handler_delegate_->OnFocus(
             FlutterViewFocusState::kUnfocused,
             FlutterViewFocusDirection::kUndefined);
       }
       break;
   }
   HWND hwnd = GetWindowHandle();
   if (hwnd && binding_handler_delegate_) {
     binding_handler_delegate_->OnWindowStateEvent(hwnd, event);
   }
 }

References GetWindowHandle(), flutter::kFocus, flutter::kHide, flutter::kShow, flutter::kUnfocus, flutter::WindowBindingHandlerDelegate::OnFocus(), and flutter::WindowBindingHandlerDelegate::OnWindowStateEvent().

Referenced by SetView().

◆ SetView()

void flutter::FlutterWindow::SetView ( WindowBindingHandlerDelegate * view )

overridevirtual

Implements flutter::WindowBindingHandler.

Definition at line 114 of file flutter_window.cc.

                                                                 {
   binding_handler_delegate_ = window;
   if (direct_manipulation_owner_) {
     direct_manipulation_owner_->SetBindingHandlerDelegate(window);
   }
   if (restored_ && window) {
     OnWindowStateEvent(WindowStateEvent::kShow);
   }
   if (focused_ && window) {
     OnWindowStateEvent(WindowStateEvent::kFocus);
   }
 }

References direct_manipulation_owner_, flutter::kFocus, flutter::kShow, and OnWindowStateEvent().

Referenced by flutter::testing::TEST_F().

◆ UpdateCursorRect()

void flutter::FlutterWindow::UpdateCursorRect ( const Rect & rect )

protectedvirtual

Definition at line 877 of file flutter_window.cc.

                                                      {
   text_input_manager_->UpdateCaretRect(rect);
 }

Referenced by OnCursorRectUpdated().

◆ Win32DefWindowProc()

LRESULT flutter::FlutterWindow::Win32DefWindowProc	(	HWND	hWnd,
		UINT	Msg,
		WPARAM	wParam,
		LPARAM	lParam
	)

protectedvirtual

Definition at line 897 of file flutter_window.cc.

                                                          {
   return ::DefWindowProc(hWnd, Msg, wParam, lParam);
 }

◆ Win32DispatchMessage()

UINT flutter::FlutterWindow::Win32DispatchMessage	(	UINT	Msg,
		WPARAM	wParam,
		LPARAM	lParam
	)

overridevirtual

Implements flutter::KeyboardManager::WindowDelegate.

Definition at line 446 of file flutter_window.cc.

                                                         {
   return ::SendMessage(window_handle_, Msg, wParam, lParam);
 }

◆ Win32MapVkToChar()

uint32_t flutter::FlutterWindow::Win32MapVkToChar ( uint32_t virtual_key )

overridevirtual

Implements flutter::KeyboardManager::WindowDelegate.

Definition at line 442 of file flutter_window.cc.

                                                              {
   return ::MapVirtualKey(virtual_key, MAPVK_VK_TO_CHAR);
 }

◆ Win32PeekMessage()

BOOL flutter::FlutterWindow::Win32PeekMessage	(	LPMSG	lpMsg,
		UINT	wMsgFilterMin,
		UINT	wMsgFilterMax,
		UINT	wRemoveMsg
	)

overridevirtual

Implements flutter::KeyboardManager::WindowDelegate.

Definition at line 434 of file flutter_window.cc.

                                                       {
   return ::PeekMessage(lpMsg, window_handle_, wMsgFilterMin, wMsgFilterMax,
                        wRemoveMsg);
 }

Friends And Related Function Documentation

◆ WindowAXFragmentRootDelegate

friend class WindowAXFragmentRootDelegate

friend

Definition at line 376 of file flutter_window.h.

Member Data Documentation

◆ alert_delegate_

std::unique_ptr<AlertPlatformNodeDelegate> flutter::FlutterWindow::alert_delegate_

protected

Definition at line 268 of file flutter_window.h.

Referenced by GetAlertDelegate().

◆ alert_node_

std::unique_ptr<ui::AXPlatformNodeWin> flutter::FlutterWindow::alert_node_

protected

Definition at line 271 of file flutter_window.h.

Referenced by GetAlert().

◆ direct_manipulation_owner_

std::unique_ptr<DirectManipulationOwner> flutter::FlutterWindow::direct_manipulation_owner_

protected

Definition at line 275 of file flutter_window.h.

Referenced by InitializeChild(), and SetView().

The documentation for this class was generated from the following files:

shell/platform/windows/flutter_window.h
shell/platform/windows/flutter_window.cc

Public Member Functions

Protected Member Functions

Protected Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ FlutterWindow() [1/2]

◆ ~FlutterWindow()

◆ FlutterWindow() [2/2]

Member Function Documentation

◆ AbortImeComposing()

◆ Focus()

◆ GetAlert()

◆ GetAlertDelegate()

◆ GetAxFragmentRootDelegate()

◆ GetCurrentDPI()

◆ GetCurrentHeight()

◆ GetCurrentWidth()

◆ GetDpiScale()

◆ GetNativeViewAccessible()

◆ GetPhysicalWindowBounds()

◆ GetPrimaryPointerLocation()

◆ GetScrollOffsetMultiplier()

◆ GetWindowHandle()

◆ HandleMessage()

◆ InitializeChild()

◆ NarrowToWide()

◆ OnBitmapSurfaceCleared()

◆ OnBitmapSurfaceUpdated()

◆ OnComposeBegin()

◆ OnComposeChange()

◆ OnComposeCommit()

◆ OnComposeEnd()

◆ OnCursorRectUpdated()

◆ OnDpiScale()

◆ OnGetObject()

◆ OnImeComposition()

◆ OnImeEndComposition()

◆ OnImeRequest()

◆ OnImeSetContext()

◆ OnImeStartComposition()

◆ OnKey()

◆ OnPaint()

◆ OnPointerDown()

◆ OnPointerLeave()

◆ OnPointerMove()

◆ OnPointerUp()

◆ OnResetImeComposing()

◆ OnResize()

◆ OnScroll()

◆ OnText()

◆ OnThemeChange()

◆ OnUpdateSemanticsEnabled()

◆ OnWindowStateEvent()

◆ SetView()

◆ UpdateCursorRect()

◆ Win32DefWindowProc()

◆ Win32DispatchMessage()

◆ Win32MapVkToChar()

◆ Win32PeekMessage()

Friends And Related Function Documentation

◆ WindowAXFragmentRootDelegate

Member Data Documentation

◆ alert_delegate_

◆ alert_node_

◆ direct_manipulation_owner_