Flutter Windows Embedder
flutter_window.cc
Go to the documentation of this file.
1 // Copyright 2013 The Flutter Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
4 
6 
7 #include <WinUser.h>
8 #include <dwmapi.h>
9 
10 #include <chrono>
11 #include <map>
12 
13 #include "flutter/fml/logging.h"
14 #include "flutter/shell/platform/embedder/embedder.h"
19 
20 namespace flutter {
21 
22 namespace {
23 
24 // The Windows DPI system is based on this
25 // constant for machines running at 100% scaling.
26 constexpr int base_dpi = 96;
27 
28 static const int kMinTouchDeviceId = 0;
29 static const int kMaxTouchDeviceId = 128;
30 
31 static const int kLinesPerScrollWindowsDefault = 3;
32 
33 // Maps a Flutter cursor name to an HCURSOR.
34 //
35 // Returns the arrow cursor for unknown constants.
36 //
37 // This map must be kept in sync with Flutter framework's
38 // services/mouse_cursor.dart.
39 static HCURSOR GetCursorByName(const std::string& cursor_name) {
40  static auto* cursors = new std::map<std::string, const wchar_t*>{
41  {"allScroll", IDC_SIZEALL},
42  {"basic", IDC_ARROW},
43  {"click", IDC_HAND},
44  {"forbidden", IDC_NO},
45  {"help", IDC_HELP},
46  {"move", IDC_SIZEALL},
47  {"none", nullptr},
48  {"noDrop", IDC_NO},
49  {"precise", IDC_CROSS},
50  {"progress", IDC_APPSTARTING},
51  {"text", IDC_IBEAM},
52  {"resizeColumn", IDC_SIZEWE},
53  {"resizeDown", IDC_SIZENS},
54  {"resizeDownLeft", IDC_SIZENESW},
55  {"resizeDownRight", IDC_SIZENWSE},
56  {"resizeLeft", IDC_SIZEWE},
57  {"resizeLeftRight", IDC_SIZEWE},
58  {"resizeRight", IDC_SIZEWE},
59  {"resizeRow", IDC_SIZENS},
60  {"resizeUp", IDC_SIZENS},
61  {"resizeUpDown", IDC_SIZENS},
62  {"resizeUpLeft", IDC_SIZENWSE},
63  {"resizeUpRight", IDC_SIZENESW},
64  {"resizeUpLeftDownRight", IDC_SIZENWSE},
65  {"resizeUpRightDownLeft", IDC_SIZENESW},
66  {"wait", IDC_WAIT},
67  };
68  const wchar_t* idc_name = IDC_ARROW;
69  auto it = cursors->find(cursor_name);
70  if (it != cursors->end()) {
71  idc_name = it->second;
72  }
73  return ::LoadCursor(nullptr, idc_name);
74 }
75 
76 static constexpr int32_t kDefaultPointerDeviceId = 0;
77 
78 // This method is only valid during a window message related to mouse/touch
79 // input.
80 // See
81 // https://docs.microsoft.com/en-us/windows/win32/tablet/system-events-and-mouse-messages?redirectedfrom=MSDN#distinguishing-pen-input-from-mouse-and-touch.
82 static FlutterPointerDeviceKind GetFlutterPointerDeviceKind() {
83  constexpr LPARAM kTouchOrPenSignature = 0xFF515700;
84  constexpr LPARAM kTouchSignature = kTouchOrPenSignature | 0x80;
85  constexpr LPARAM kSignatureMask = 0xFFFFFF00;
86  LPARAM info = GetMessageExtraInfo();
87  if ((info & kSignatureMask) == kTouchOrPenSignature) {
88  if ((info & kTouchSignature) == kTouchSignature) {
89  return kFlutterPointerDeviceKindTouch;
90  }
91  return kFlutterPointerDeviceKindStylus;
92  }
93  return kFlutterPointerDeviceKindMouse;
94 }
95 
96 // Translates button codes from Win32 API to FlutterPointerMouseButtons.
97 static uint64_t ConvertWinButtonToFlutterButton(UINT button) {
98  switch (button) {
99  case WM_LBUTTONDOWN:
100  case WM_LBUTTONUP:
101  return kFlutterPointerButtonMousePrimary;
102  case WM_RBUTTONDOWN:
103  case WM_RBUTTONUP:
104  return kFlutterPointerButtonMouseSecondary;
105  case WM_MBUTTONDOWN:
106  case WM_MBUTTONUP:
107  return kFlutterPointerButtonMouseMiddle;
108  case XBUTTON1:
109  return kFlutterPointerButtonMouseBack;
110  case XBUTTON2:
111  return kFlutterPointerButtonMouseForward;
112  }
113  FML_LOG(WARNING) << "Mouse button not recognized: " << button;
114  return 0;
115 }
116 
117 } // namespace
118 
120  int width,
121  int height,
122  std::shared_ptr<WindowsProcTable> windows_proc_table,
123  std::unique_ptr<TextInputManager> text_input_manager)
124  : binding_handler_delegate_(nullptr),
125  touch_id_generator_(kMinTouchDeviceId, kMaxTouchDeviceId),
126  windows_proc_table_(std::move(windows_proc_table)),
127  text_input_manager_(std::move(text_input_manager)),
128  ax_fragment_root_(nullptr) {
129  // Get the DPI of the primary monitor as the initial DPI. If Per-Monitor V2 is
130  // supported, |current_dpi_| should be updated in the
131  // kWmDpiChangedBeforeParent message.
132  current_dpi_ = GetDpiForHWND(nullptr);
133 
134  // Get initial value for wheel scroll lines
135  // TODO: Listen to changes for this value
136  // https://github.com/flutter/flutter/issues/107248
137  UpdateScrollOffsetMultiplier();
138 
139  if (windows_proc_table_ == nullptr) {
140  windows_proc_table_ = std::make_unique<WindowsProcTable>();
141  }
142  if (text_input_manager_ == nullptr) {
143  text_input_manager_ = std::make_unique<TextInputManager>();
144  }
145  keyboard_manager_ = std::make_unique<KeyboardManager>(this);
146 
147  InitializeChild("FLUTTERVIEW", width, height);
148  current_cursor_ = ::LoadCursor(nullptr, IDC_ARROW);
149 }
150 
153  Destroy();
154 }
155 
157  binding_handler_delegate_ = window;
158  direct_manipulation_owner_->SetBindingHandlerDelegate(window);
159  if (restored_ && window) {
161  }
162  if (focused_ && window) {
164  }
165 }
166 
168  return static_cast<float>(GetCurrentDPI()) / static_cast<float>(base_dpi);
169 }
170 
172  return IsWindowVisible(GetWindowHandle());
173 }
174 
176  return {GetCurrentWidth(), GetCurrentHeight()};
177 }
178 
179 void FlutterWindow::UpdateFlutterCursor(const std::string& cursor_name) {
180  current_cursor_ = GetCursorByName(cursor_name);
181 }
182 
183 void FlutterWindow::SetFlutterCursor(HCURSOR cursor) {
184  current_cursor_ = cursor;
185  ::SetCursor(current_cursor_);
186 }
187 
188 void FlutterWindow::OnDpiScale(unsigned int dpi) {};
189 
190 // When DesktopWindow notifies that a WM_Size message has come in
191 // lets FlutterEngine know about the new size.
192 void FlutterWindow::OnResize(unsigned int width, unsigned int height) {
193  if (binding_handler_delegate_ != nullptr) {
194  binding_handler_delegate_->OnWindowSizeChanged(width, height);
195  }
196 }
197 
199  if (binding_handler_delegate_ != nullptr) {
200  binding_handler_delegate_->OnWindowRepaint();
201  }
202 }
203 
205  double y,
206  FlutterPointerDeviceKind device_kind,
207  int32_t device_id,
208  int modifiers_state) {
209  binding_handler_delegate_->OnPointerMove(x, y, device_kind, device_id,
210  modifiers_state);
211 }
212 
214  double y,
215  FlutterPointerDeviceKind device_kind,
216  int32_t device_id,
217  UINT button) {
218  uint64_t flutter_button = ConvertWinButtonToFlutterButton(button);
219  if (flutter_button != 0) {
220  binding_handler_delegate_->OnPointerDown(
221  x, y, device_kind, device_id,
222  static_cast<FlutterPointerMouseButtons>(flutter_button));
223  }
224 }
225 
227  double y,
228  FlutterPointerDeviceKind device_kind,
229  int32_t device_id,
230  UINT button) {
231  uint64_t flutter_button = ConvertWinButtonToFlutterButton(button);
232  if (flutter_button != 0) {
233  binding_handler_delegate_->OnPointerUp(
234  x, y, device_kind, device_id,
235  static_cast<FlutterPointerMouseButtons>(flutter_button));
236  }
237 }
238 
240  double y,
241  FlutterPointerDeviceKind device_kind,
242  int32_t device_id) {
243  binding_handler_delegate_->OnPointerLeave(x, y, device_kind, device_id);
244 }
245 
247  ::SetCursor(current_cursor_);
248 }
249 
250 void FlutterWindow::OnText(const std::u16string& text) {
251  binding_handler_delegate_->OnText(text);
252 }
253 
255  int scancode,
256  int action,
257  char32_t character,
258  bool extended,
259  bool was_down,
261  binding_handler_delegate_->OnKey(key, scancode, action, character, extended,
262  was_down, std::move(callback));
263 }
264 
266  binding_handler_delegate_->OnComposeBegin();
267 }
268 
270  binding_handler_delegate_->OnComposeCommit();
271 }
272 
274  binding_handler_delegate_->OnComposeEnd();
275 }
276 
277 void FlutterWindow::OnComposeChange(const std::u16string& text,
278  int cursor_pos) {
279  binding_handler_delegate_->OnComposeChange(text, cursor_pos);
280 }
281 
283  binding_handler_delegate_->OnUpdateSemanticsEnabled(enabled);
284 }
285 
286 void FlutterWindow::OnScroll(double delta_x,
287  double delta_y,
288  FlutterPointerDeviceKind device_kind,
289  int32_t device_id) {
290  POINT point;
291  GetCursorPos(&point);
292 
293  ScreenToClient(GetWindowHandle(), &point);
294  binding_handler_delegate_->OnScroll(point.x, point.y, delta_x, delta_y,
295  GetScrollOffsetMultiplier(), device_kind,
296  device_id);
297 }
298 
300  // Convert the rect from Flutter logical coordinates to device coordinates.
301  auto scale = GetDpiScale();
302  Point origin(rect.left() * scale, rect.top() * scale);
303  Size size(rect.width() * scale, rect.height() * scale);
304  UpdateCursorRect(Rect(origin, size));
305 }
306 
309 }
310 
311 bool FlutterWindow::OnBitmapSurfaceUpdated(const void* allocation,
312  size_t row_bytes,
313  size_t height) {
314  HDC dc = ::GetDC(GetWindowHandle());
315  BITMAPINFO bmi = {};
316  bmi.bmiHeader.biSize = sizeof(BITMAPINFOHEADER);
317  bmi.bmiHeader.biWidth = row_bytes / 4;
318  bmi.bmiHeader.biHeight = -height;
319  bmi.bmiHeader.biPlanes = 1;
320  bmi.bmiHeader.biBitCount = 32;
321  bmi.bmiHeader.biCompression = BI_RGB;
322  bmi.bmiHeader.biSizeImage = 0;
323  int ret = SetDIBitsToDevice(dc, 0, 0, row_bytes / 4, height, 0, 0, 0, height,
324  allocation, &bmi, DIB_RGB_COLORS);
325  ::ReleaseDC(GetWindowHandle(), dc);
326  return ret != 0;
327 }
328 
329 gfx::NativeViewAccessible FlutterWindow::GetNativeViewAccessible() {
330  if (binding_handler_delegate_ == nullptr) {
331  return nullptr;
332  }
333 
334  return binding_handler_delegate_->GetNativeViewAccessible();
335 }
336 
338  POINT point;
339  GetCursorPos(&point);
340  ScreenToClient(GetWindowHandle(), &point);
341  return {(size_t)point.x, (size_t)point.y};
342 }
343 
345  binding_handler_delegate_->OnHighContrastChanged();
346 }
347 
348 ui::AXFragmentRootDelegateWin* FlutterWindow::GetAxFragmentRootDelegate() {
349  return binding_handler_delegate_->GetAxFragmentRootDelegate();
350 }
351 
353  CreateAxFragmentRoot();
354  return alert_delegate_.get();
355 }
356 
357 ui::AXPlatformNodeWin* FlutterWindow::GetAlert() {
358  CreateAxFragmentRoot();
359  return alert_node_.get();
360 }
361 
363  switch (event) {
365  restored_ = true;
366  break;
368  restored_ = false;
369  focused_ = false;
370  break;
372  focused_ = true;
373  break;
375  focused_ = false;
376  break;
377  }
378  HWND hwnd = GetWindowHandle();
379  if (hwnd && binding_handler_delegate_) {
380  binding_handler_delegate_->OnWindowStateEvent(hwnd, event);
381  }
382 }
383 
384 void FlutterWindow::TrackMouseLeaveEvent(HWND hwnd) {
385  if (!tracking_mouse_leave_) {
386  TRACKMOUSEEVENT tme;
387  tme.cbSize = sizeof(tme);
388  tme.hwndTrack = hwnd;
389  tme.dwFlags = TME_LEAVE;
390  TrackMouseEvent(&tme);
391  tracking_mouse_leave_ = true;
392  }
393 }
394 
395 void FlutterWindow::HandleResize(UINT width, UINT height) {
396  current_width_ = width;
397  current_height_ = height;
399  direct_manipulation_owner_->ResizeViewport(width, height);
400  }
401  OnResize(width, height);
402 }
403 
404 FlutterWindow* FlutterWindow::GetThisFromHandle(HWND const window) noexcept {
405  return reinterpret_cast<FlutterWindow*>(
406  GetWindowLongPtr(window, GWLP_USERDATA));
407 }
408 
409 void FlutterWindow::UpdateScrollOffsetMultiplier() {
410  UINT lines_per_scroll = kLinesPerScrollWindowsDefault;
411 
412  // Get lines per scroll wheel value from Windows
413  SystemParametersInfo(SPI_GETWHEELSCROLLLINES, 0, &lines_per_scroll, 0);
414 
415  // This logic is based off Chromium's implementation
416  // https://source.chromium.org/chromium/chromium/src/+/main:ui/events/blink/web_input_event_builders_win.cc;l=319-331
417  scroll_offset_multiplier_ =
418  static_cast<float>(lines_per_scroll) * 100.0 / 3.0;
419 }
420 
421 void FlutterWindow::InitializeChild(const char* title,
422  unsigned int width,
423  unsigned int height) {
424  Destroy();
425  std::wstring converted_title = NarrowToWide(title);
426 
427  WNDCLASS window_class = RegisterWindowClass(converted_title);
428 
429  auto* result = CreateWindowEx(
430  0, window_class.lpszClassName, converted_title.c_str(),
431  WS_CHILD | WS_VISIBLE, CW_DEFAULT, CW_DEFAULT, width, height,
432  HWND_MESSAGE, nullptr, window_class.hInstance, this);
433 
434  if (result == nullptr) {
435  auto error = GetLastError();
436  LPWSTR message = nullptr;
437  size_t size = FormatMessageW(
438  FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
439  FORMAT_MESSAGE_IGNORE_INSERTS,
440  NULL, error, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
441  reinterpret_cast<LPWSTR>(&message), 0, NULL);
442  OutputDebugString(message);
443  LocalFree(message);
444  }
445  SetUserObjectInformationA(GetCurrentProcess(),
446  UOI_TIMERPROC_EXCEPTION_SUPPRESSION, FALSE, 1);
447  // SetTimer is not precise, if a 16 ms interval is requested, it will instead
448  // often fire in an interval of 32 ms. Providing a value of 14 will ensure it
449  // runs every 16 ms, which will allow for 60 Hz trackpad gesture events, which
450  // is the maximal frequency supported by SetTimer.
451  SetTimer(result, kDirectManipulationTimer, 14, nullptr);
452  direct_manipulation_owner_ = std::make_unique<DirectManipulationOwner>(this);
453  direct_manipulation_owner_->Init(width, height);
454 }
455 
457  return window_handle_;
458 }
459 
461  UINT wMsgFilterMin,
462  UINT wMsgFilterMax,
463  UINT wRemoveMsg) {
464  return ::PeekMessage(lpMsg, window_handle_, wMsgFilterMin, wMsgFilterMax,
465  wRemoveMsg);
466 }
467 
468 uint32_t FlutterWindow::Win32MapVkToChar(uint32_t virtual_key) {
469  return ::MapVirtualKey(virtual_key, MAPVK_VK_TO_CHAR);
470 }
471 
473  WPARAM wParam,
474  LPARAM lParam) {
475  return ::SendMessage(window_handle_, Msg, wParam, lParam);
476 }
477 
478 std::wstring FlutterWindow::NarrowToWide(const char* source) {
479  size_t length = strlen(source);
480  size_t outlen = 0;
481  std::wstring wideTitle(length, L'#');
482  mbstowcs_s(&outlen, &wideTitle[0], length + 1, source, length);
483  return wideTitle;
484 }
485 
486 WNDCLASS FlutterWindow::RegisterWindowClass(std::wstring& title) {
487  window_class_name_ = title;
488 
489  WNDCLASS window_class{};
490  window_class.hCursor = LoadCursor(nullptr, IDC_ARROW);
491  window_class.lpszClassName = title.c_str();
492  window_class.style = CS_HREDRAW | CS_VREDRAW;
493  window_class.cbClsExtra = 0;
494  window_class.cbWndExtra = 0;
495  window_class.hInstance = GetModuleHandle(nullptr);
496  window_class.hIcon = nullptr;
497  window_class.hbrBackground = 0;
498  window_class.lpszMenuName = nullptr;
499  window_class.lpfnWndProc = WndProc;
500  RegisterClass(&window_class);
501  return window_class;
502 }
503 
504 LRESULT CALLBACK FlutterWindow::WndProc(HWND const window,
505  UINT const message,
506  WPARAM const wparam,
507  LPARAM const lparam) noexcept {
508  if (message == WM_NCCREATE) {
509  auto cs = reinterpret_cast<CREATESTRUCT*>(lparam);
510  SetWindowLongPtr(window, GWLP_USERDATA,
511  reinterpret_cast<LONG_PTR>(cs->lpCreateParams));
512 
513  auto that = static_cast<FlutterWindow*>(cs->lpCreateParams);
514  that->window_handle_ = window;
515  that->text_input_manager_->SetWindowHandle(window);
516  RegisterTouchWindow(window, 0);
517  } else if (FlutterWindow* that = GetThisFromHandle(window)) {
518  return that->HandleMessage(message, wparam, lparam);
519  }
520 
521  return DefWindowProc(window, message, wparam, lparam);
522 }
523 
524 LRESULT
526  WPARAM const wparam,
527  LPARAM const lparam) noexcept {
528  LPARAM result_lparam = lparam;
529  int xPos = 0, yPos = 0;
530  UINT width = 0, height = 0;
531  UINT button_pressed = 0;
532  FlutterPointerDeviceKind device_kind;
533 
534  switch (message) {
535  case kWmDpiChangedBeforeParent:
536  current_dpi_ = GetDpiForHWND(window_handle_);
537  OnDpiScale(current_dpi_);
538  return 0;
539  case WM_SIZE:
540  width = LOWORD(lparam);
541  height = HIWORD(lparam);
542 
543  current_width_ = width;
544  current_height_ = height;
545  HandleResize(width, height);
546 
547  OnWindowStateEvent(width == 0 && height == 0 ? WindowStateEvent::kHide
549  break;
550  case WM_PAINT:
551  OnPaint();
552  break;
553  case WM_TOUCH: {
554  UINT num_points = LOWORD(wparam);
555  touch_points_.resize(num_points);
556  auto touch_input_handle = reinterpret_cast<HTOUCHINPUT>(lparam);
557  if (GetTouchInputInfo(touch_input_handle, num_points,
558  touch_points_.data(), sizeof(TOUCHINPUT))) {
559  for (const auto& touch : touch_points_) {
560  // Generate a mapped ID for the Windows-provided touch ID
561  auto touch_id = touch_id_generator_.GetGeneratedId(touch.dwID);
562 
563  POINT pt = {TOUCH_COORD_TO_PIXEL(touch.x),
564  TOUCH_COORD_TO_PIXEL(touch.y)};
565  ScreenToClient(window_handle_, &pt);
566  auto x = static_cast<double>(pt.x);
567  auto y = static_cast<double>(pt.y);
568 
569  if (touch.dwFlags & TOUCHEVENTF_DOWN) {
570  OnPointerDown(x, y, kFlutterPointerDeviceKindTouch, touch_id,
571  WM_LBUTTONDOWN);
572  } else if (touch.dwFlags & TOUCHEVENTF_MOVE) {
573  OnPointerMove(x, y, kFlutterPointerDeviceKindTouch, touch_id, 0);
574  } else if (touch.dwFlags & TOUCHEVENTF_UP) {
575  OnPointerUp(x, y, kFlutterPointerDeviceKindTouch, touch_id,
576  WM_LBUTTONDOWN);
577  OnPointerLeave(x, y, kFlutterPointerDeviceKindTouch, touch_id);
578  touch_id_generator_.ReleaseNumber(touch.dwID);
579  }
580  }
581  CloseTouchInputHandle(touch_input_handle);
582  }
583  return 0;
584  }
585  case WM_MOUSEMOVE:
586  device_kind = GetFlutterPointerDeviceKind();
587  if (device_kind == kFlutterPointerDeviceKindMouse) {
588  TrackMouseLeaveEvent(window_handle_);
589 
590  xPos = GET_X_LPARAM(lparam);
591  yPos = GET_Y_LPARAM(lparam);
592  mouse_x_ = static_cast<double>(xPos);
593  mouse_y_ = static_cast<double>(yPos);
594 
595  int mods = 0;
596  if (wparam & MK_CONTROL) {
597  mods |= kControl;
598  }
599  if (wparam & MK_SHIFT) {
600  mods |= kShift;
601  }
602  OnPointerMove(mouse_x_, mouse_y_, device_kind, kDefaultPointerDeviceId,
603  mods);
604  }
605  break;
606  case WM_MOUSELEAVE:
607  device_kind = GetFlutterPointerDeviceKind();
608  if (device_kind == kFlutterPointerDeviceKindMouse) {
609  OnPointerLeave(mouse_x_, mouse_y_, device_kind,
610  kDefaultPointerDeviceId);
611  }
612 
613  // Once the tracked event is received, the TrackMouseEvent function
614  // resets. Set to false to make sure it's called once mouse movement is
615  // detected again.
616  tracking_mouse_leave_ = false;
617  break;
618  case WM_SETCURSOR: {
619  UINT hit_test_result = LOWORD(lparam);
620  if (hit_test_result == HTCLIENT) {
621  OnSetCursor();
622  return TRUE;
623  }
624  break;
625  }
626  case WM_SETFOCUS:
627  OnWindowStateEvent(WindowStateEvent::kFocus);
628  ::CreateCaret(window_handle_, nullptr, 1, 1);
629  break;
630  case WM_KILLFOCUS:
631  OnWindowStateEvent(WindowStateEvent::kUnfocus);
632  ::DestroyCaret();
633  break;
634  case WM_LBUTTONDOWN:
635  case WM_RBUTTONDOWN:
636  case WM_MBUTTONDOWN:
637  case WM_XBUTTONDOWN:
638  device_kind = GetFlutterPointerDeviceKind();
639  if (device_kind != kFlutterPointerDeviceKindMouse) {
640  break;
641  }
642 
643  if (message == WM_LBUTTONDOWN) {
644  // Capture the pointer in case the user drags outside the client area.
645  // In this case, the "mouse leave" event is delayed until the user
646  // releases the button. It's only activated on left click given that
647  // it's more common for apps to handle dragging with only the left
648  // button.
649  SetCapture(window_handle_);
650  }
651  button_pressed = message;
652  if (message == WM_XBUTTONDOWN) {
653  button_pressed = GET_XBUTTON_WPARAM(wparam);
654  }
655  xPos = GET_X_LPARAM(lparam);
656  yPos = GET_Y_LPARAM(lparam);
657  OnPointerDown(static_cast<double>(xPos), static_cast<double>(yPos),
658  device_kind, kDefaultPointerDeviceId, button_pressed);
659  break;
660  case WM_LBUTTONUP:
661  case WM_RBUTTONUP:
662  case WM_MBUTTONUP:
663  case WM_XBUTTONUP:
664  device_kind = GetFlutterPointerDeviceKind();
665  if (device_kind != kFlutterPointerDeviceKindMouse) {
666  break;
667  }
668 
669  if (message == WM_LBUTTONUP) {
670  ReleaseCapture();
671  }
672  button_pressed = message;
673  if (message == WM_XBUTTONUP) {
674  button_pressed = GET_XBUTTON_WPARAM(wparam);
675  }
676  xPos = GET_X_LPARAM(lparam);
677  yPos = GET_Y_LPARAM(lparam);
678  OnPointerUp(static_cast<double>(xPos), static_cast<double>(yPos),
679  device_kind, kDefaultPointerDeviceId, button_pressed);
680  break;
681  case WM_MOUSEWHEEL:
682  OnScroll(0.0,
683  -(static_cast<short>(HIWORD(wparam)) /
684  static_cast<double>(WHEEL_DELTA)),
685  kFlutterPointerDeviceKindMouse, kDefaultPointerDeviceId);
686  break;
687  case WM_MOUSEHWHEEL:
688  OnScroll((static_cast<short>(HIWORD(wparam)) /
689  static_cast<double>(WHEEL_DELTA)),
690  0.0, kFlutterPointerDeviceKindMouse, kDefaultPointerDeviceId);
691  break;
692  case WM_GETOBJECT: {
693  LRESULT lresult = OnGetObject(message, wparam, lparam);
694  if (lresult) {
695  return lresult;
696  }
697  break;
698  }
699  case WM_TIMER:
700  if (wparam == kDirectManipulationTimer) {
701  direct_manipulation_owner_->Update();
702  return 0;
703  }
704  break;
705  case DM_POINTERHITTEST: {
706  if (direct_manipulation_owner_) {
707  UINT contact_id = GET_POINTERID_WPARAM(wparam);
708  POINTER_INPUT_TYPE pointer_type;
709  if (windows_proc_table_->GetPointerType(contact_id, &pointer_type) &&
710  pointer_type == PT_TOUCHPAD) {
711  direct_manipulation_owner_->SetContact(contact_id);
712  }
713  }
714  break;
715  }
716  case WM_INPUTLANGCHANGE:
717  // TODO(cbracken): pass this to TextInputManager to aid with
718  // language-specific issues.
719  break;
720  case WM_IME_SETCONTEXT:
721  OnImeSetContext(message, wparam, lparam);
722  // Strip the ISC_SHOWUICOMPOSITIONWINDOW bit from lparam before passing it
723  // to DefWindowProc() so that the composition window is hidden since
724  // Flutter renders the composing string itself.
725  result_lparam &= ~ISC_SHOWUICOMPOSITIONWINDOW;
726  break;
727  case WM_IME_STARTCOMPOSITION:
728  OnImeStartComposition(message, wparam, lparam);
729  // Suppress further processing by DefWindowProc() so that the default
730  // system IME style isn't used, but rather the one set in the
731  // WM_IME_SETCONTEXT handler.
732  return TRUE;
733  case WM_IME_COMPOSITION:
734  OnImeComposition(message, wparam, lparam);
735  if (lparam & GCS_RESULTSTR || lparam & GCS_COMPSTR) {
736  // Suppress further processing by DefWindowProc() since otherwise it
737  // will emit the result string as WM_CHAR messages on commit. Instead,
738  // committing the composing text to the EditableText string is handled
739  // in TextInputModel::CommitComposing, triggered by
740  // OnImeEndComposition().
741  return TRUE;
742  }
743  break;
744  case WM_IME_ENDCOMPOSITION:
745  OnImeEndComposition(message, wparam, lparam);
746  return TRUE;
747  case WM_IME_REQUEST:
748  OnImeRequest(message, wparam, lparam);
749  break;
750  case WM_UNICHAR: {
751  // Tell third-pary app, we can support Unicode.
752  if (wparam == UNICODE_NOCHAR)
753  return TRUE;
754  // DefWindowProc will send WM_CHAR for this WM_UNICHAR.
755  break;
756  }
757  case WM_THEMECHANGED:
758  OnThemeChange();
759  break;
760  case WM_DEADCHAR:
761  case WM_SYSDEADCHAR:
762  case WM_CHAR:
763  case WM_SYSCHAR:
764  case WM_KEYDOWN:
765  case WM_SYSKEYDOWN:
766  case WM_KEYUP:
767  case WM_SYSKEYUP:
768  if (keyboard_manager_->HandleMessage(message, wparam, lparam)) {
769  return 0;
770  }
771  break;
772  }
773 
774  return Win32DefWindowProc(window_handle_, message, wparam, result_lparam);
775 }
776 
778  WPARAM const wparam,
779  LPARAM const lparam) {
780  LRESULT reference_result = static_cast<LRESULT>(0L);
781 
782  // Only the lower 32 bits of lparam are valid when checking the object id
783  // because it sometimes gets sign-extended incorrectly (but not always).
784  DWORD obj_id = static_cast<DWORD>(static_cast<DWORD_PTR>(lparam));
785 
786  bool is_uia_request = static_cast<DWORD>(UiaRootObjectId) == obj_id;
787  bool is_msaa_request = static_cast<DWORD>(OBJID_CLIENT) == obj_id;
788 
789  if (is_uia_request || is_msaa_request) {
790  // On Windows, we don't get a notification that the screen reader has been
791  // enabled or disabled. There is an API to query for screen reader state,
792  // but that state isn't set by all screen readers, including by Narrator,
793  // the screen reader that ships with Windows:
794  // https://docs.microsoft.com/en-us/windows/win32/winauto/screen-reader-parameter
795  //
796  // Instead, we enable semantics in Flutter if Windows issues queries for
797  // Microsoft Active Accessibility (MSAA) COM objects.
799  }
800 
801  gfx::NativeViewAccessible root_view = GetNativeViewAccessible();
802  // TODO(schectman): UIA is currently disabled by default.
803  // https://github.com/flutter/flutter/issues/114547
804  if (root_view) {
805  CreateAxFragmentRoot();
806  if (is_uia_request) {
807 #ifdef FLUTTER_ENGINE_USE_UIA
808  // Retrieve UIA object for the root view.
809  Microsoft::WRL::ComPtr<IRawElementProviderSimple> root;
810  if (SUCCEEDED(
811  ax_fragment_root_->GetNativeViewAccessible()->QueryInterface(
812  IID_PPV_ARGS(&root)))) {
813  // Return the UIA object via UiaReturnRawElementProvider(). See:
814  // https://docs.microsoft.com/en-us/windows/win32/winauto/wm-getobject
815  reference_result = UiaReturnRawElementProvider(window_handle_, wparam,
816  lparam, root.Get());
817  } else {
818  FML_LOG(ERROR) << "Failed to query AX fragment root.";
819  }
820 #endif // FLUTTER_ENGINE_USE_UIA
821  } else if (is_msaa_request) {
822  // Create the accessibility root if it does not already exist.
823  // Return the IAccessible for the root view.
824  Microsoft::WRL::ComPtr<IAccessible> root;
825  ax_fragment_root_->GetNativeViewAccessible()->QueryInterface(
826  IID_PPV_ARGS(&root));
827  reference_result = LresultFromObject(IID_IAccessible, wparam, root.Get());
828  }
829  }
830  return reference_result;
831 }
832 
834  WPARAM const wparam,
835  LPARAM const lparam) {
836  if (wparam != 0) {
837  text_input_manager_->CreateImeWindow();
838  }
839 }
840 
842  WPARAM const wparam,
843  LPARAM const lparam) {
844  text_input_manager_->CreateImeWindow();
845  OnComposeBegin();
846 }
847 
849  WPARAM const wparam,
850  LPARAM const lparam) {
851  // Update the IME window position.
852  text_input_manager_->UpdateImeWindow();
853 
854  if (lparam == 0) {
855  OnComposeChange(u"", 0);
856  OnComposeCommit();
857  }
858 
859  // Process GCS_RESULTSTR at fisrt, because Google Japanese Input and ATOK send
860  // both GCS_RESULTSTR and GCS_COMPSTR to commit composed text and send new
861  // composing text.
862  if (lparam & GCS_RESULTSTR) {
863  // Commit but don't end composing.
864  // Read the committed composing string.
865  long pos = text_input_manager_->GetComposingCursorPosition();
866  std::optional<std::u16string> text = text_input_manager_->GetResultString();
867  if (text) {
868  OnComposeChange(text.value(), pos);
869  OnComposeCommit();
870  }
871  }
872  if (lparam & GCS_COMPSTR) {
873  // Read the in-progress composing string.
874  long pos = text_input_manager_->GetComposingCursorPosition();
875  std::optional<std::u16string> text =
876  text_input_manager_->GetComposingString();
877  if (text) {
878  OnComposeChange(text.value(), pos);
879  }
880  }
881 }
882 
884  WPARAM const wparam,
885  LPARAM const lparam) {
886  text_input_manager_->DestroyImeWindow();
887  OnComposeEnd();
888 }
889 
891  WPARAM const wparam,
892  LPARAM const lparam) {
893  // TODO(cbracken): Handle IMR_RECONVERTSTRING, IMR_DOCUMENTFEED,
894  // and IMR_QUERYCHARPOSITION messages.
895  // https://github.com/flutter/flutter/issues/74547
896 }
897 
899  text_input_manager_->AbortComposing();
900 }
901 
903  text_input_manager_->UpdateCaretRect(rect);
904 }
905 
907  return current_dpi_;
908 }
909 
911  return current_width_;
912 }
913 
915  return current_height_;
916 }
917 
919  return scroll_offset_multiplier_;
920 }
921 
923  UINT Msg,
924  WPARAM wParam,
925  LPARAM lParam) {
926  return ::DefWindowProc(hWnd, Msg, wParam, lParam);
927 }
928 
929 void FlutterWindow::Destroy() {
930  if (window_handle_) {
931  text_input_manager_->SetWindowHandle(nullptr);
932  DestroyWindow(window_handle_);
933  window_handle_ = nullptr;
934  }
935 
936  UnregisterClass(window_class_name_.c_str(), nullptr);
937 }
938 
939 void FlutterWindow::CreateAxFragmentRoot() {
940  if (ax_fragment_root_) {
941  return;
942  }
943  ax_fragment_root_ = std::make_unique<ui::AXFragmentRootWin>(
944  window_handle_, GetAxFragmentRootDelegate());
946  std::make_unique<AlertPlatformNodeDelegate>(*ax_fragment_root_);
947  ui::AXPlatformNode* alert_node =
948  ui::AXPlatformNodeWin::Create(alert_delegate_.get());
949  alert_node_.reset(static_cast<ui::AXPlatformNodeWin*>(alert_node));
950  ax_fragment_root_->SetAlertNode(alert_node_.get());
951 }
952 
953 } // namespace flutter
flutter::AlertPlatformNodeDelegate
Definition: alert_platform_node_delegate.h:18
flutter::WindowStateEvent
WindowStateEvent
An event representing a change in window state that may update the.
Definition: windows_lifecycle_manager.h:24
flutter::FlutterWindow::GetWindowHandle
virtual HWND GetWindowHandle() override
Definition: flutter_window.cc:456
flutter::WindowBindingHandlerDelegate::OnWindowRepaint
virtual void OnWindowRepaint()=0
flutter::Rect::width
double width() const
Definition: geometry.h:67
flutter::FlutterWindow::GetCurrentHeight
UINT GetCurrentHeight()
Definition: flutter_window.cc:914
flutter::WindowStateEvent::kHide
@ kHide
flutter::FlutterWindow::OnComposeBegin
virtual void OnComposeBegin()
Definition: flutter_window.cc:265
scancode
int scancode
Definition: keyboard_key_handler_unittests.cc:115
flutter::FlutterWindow::GetDpiScale
virtual float GetDpiScale() override
Definition: flutter_window.cc:167
was_down
bool was_down
Definition: keyboard_key_handler_unittests.cc:119
extended
bool extended
Definition: keyboard_key_handler_unittests.cc:118
flutter::FlutterWindow::Win32DispatchMessage
virtual UINT Win32DispatchMessage(UINT Msg, WPARAM wParam, LPARAM lParam) override
Definition: flutter_window.cc:472
flutter::FlutterWindow::OnThemeChange
virtual void OnThemeChange()
Definition: flutter_window.cc:344
flutter::FlutterWindow::OnPointerDown
virtual void OnPointerDown(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, UINT button)
Definition: flutter_window.cc:213
flutter::FlutterWindow::OnCursorRectUpdated
virtual void OnCursorRectUpdated(const Rect &rect) override
Definition: flutter_window.cc:299
character
char32_t character
Definition: keyboard_key_handler_unittests.cc:117
flutter::KeyboardManager::WindowDelegate::KeyEventCallback
std::function< void(bool)> KeyEventCallback
Definition: keyboard_manager.h:54
flutter::FlutterWindow::FlutterWindow
FlutterWindow(int width, int height, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr, std::unique_ptr< TextInputManager > text_input_manager=nullptr)
Definition: flutter_window.cc:119
flutter::FlutterWindow::GetCurrentWidth
UINT GetCurrentWidth()
Definition: flutter_window.cc:910
flutter::FlutterWindow::NarrowToWide
std::wstring NarrowToWide(const char *source)
Definition: flutter_window.cc:478
flutter::FlutterWindow::OnImeEndComposition
virtual void OnImeEndComposition(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:883
flutter::WindowBindingHandlerDelegate::OnPointerMove
virtual void OnPointerMove(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, int modifiers_state)=0
flutter::WindowBindingHandlerDelegate
Definition: window_binding_handler_delegate.h:18
flutter::FlutterWindow::OnGetObject
virtual LRESULT OnGetObject(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:777
flutter::FlutterWindow::InitializeChild
void InitializeChild(const char *title, unsigned int width, unsigned int height)
Definition: flutter_window.cc:421
flutter::Rect
Definition: geometry.h:56
flutter::FlutterWindow::AbortImeComposing
virtual void AbortImeComposing()
Definition: flutter_window.cc:898
flutter::PhysicalWindowBounds
Definition: window_binding_handler.h:27
flutter::PointerLocation
Definition: window_binding_handler.h:34
flutter::WindowBindingHandlerDelegate::GetAxFragmentRootDelegate
virtual ui::AXFragmentRootDelegateWin * GetAxFragmentRootDelegate()=0
flutter::WindowBindingHandlerDelegate::OnHighContrastChanged
virtual void OnHighContrastChanged()=0
flutter::GetDpiForHWND
UINT GetDpiForHWND(HWND hwnd)
Definition: dpi_utils.cc:130
flutter::FlutterWindow::OnBitmapSurfaceUpdated
virtual bool OnBitmapSurfaceUpdated(const void *allocation, size_t row_bytes, size_t height) override
Definition: flutter_window.cc:311
flutter::FlutterWindow::OnPointerMove
virtual void OnPointerMove(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, int modifiers_state)
Definition: flutter_window.cc:204
flutter::FlutterWindow::GetAxFragmentRootDelegate
virtual ui::AXFragmentRootDelegateWin * GetAxFragmentRootDelegate()
Definition: flutter_window.cc:348
flutter::FlutterWindow::OnText
virtual void OnText(const std::u16string &text) override
Definition: flutter_window.cc:250
flutter::FlutterWindow::GetAlert
virtual ui::AXPlatformNodeWin * GetAlert() override
Definition: flutter_window.cc:357
flutter::FlutterWindow::direct_manipulation_owner_
std::unique_ptr< DirectManipulationOwner > direct_manipulation_owner_
Definition: flutter_window.h:278
flutter::FlutterWindow::Win32PeekMessage
virtual BOOL Win32PeekMessage(LPMSG lpMsg, UINT wMsgFilterMin, UINT wMsgFilterMax, UINT wRemoveMsg) override
Definition: flutter_window.cc:460
flutter::WindowBindingHandlerDelegate::OnText
virtual void OnText(const std::u16string &)=0
flutter::FlutterWindow::OnPointerLeave
virtual void OnPointerLeave(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id)
Definition: flutter_window.cc:239
flutter::FlutterWindow::GetCurrentDPI
UINT GetCurrentDPI()
Definition: flutter_window.cc:906
flutter::Rect::left
double left() const
Definition: geometry.h:63
flutter::FlutterWindow::OnUpdateSemanticsEnabled
virtual void OnUpdateSemanticsEnabled(bool enabled)
Definition: flutter_window.cc:282
flutter::FlutterWindow::OnPointerUp
virtual void OnPointerUp(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, UINT button)
Definition: flutter_window.cc:226
flutter::FlutterWindow::GetNativeViewAccessible
virtual gfx::NativeViewAccessible GetNativeViewAccessible()
Definition: flutter_window.cc:329
flutter::FlutterWindow::UpdateFlutterCursor
virtual void UpdateFlutterCursor(const std::string &cursor_name) override
Definition: flutter_window.cc:179
flutter::FlutterWindow::OnImeSetContext
virtual void OnImeSetContext(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:833
flutter_windows_view.h
text
std::u16string text
Definition: keyboard_unittests.cc:332
flutter::FlutterWindow::SetFlutterCursor
virtual void SetFlutterCursor(HCURSOR cursor) override
Definition: flutter_window.cc:183
flutter::FlutterWindow::~FlutterWindow
virtual ~FlutterWindow()
Definition: flutter_window.cc:151
keyboard_utils.h
flutter::WindowStateEvent::kFocus
@ kFocus
flutter_window.h
flutter::FlutterWindow::SetView
virtual void SetView(WindowBindingHandlerDelegate *view) override
Definition: flutter_window.cc:156
flutter::FlutterWindow::GetPrimaryPointerLocation
virtual PointerLocation GetPrimaryPointerLocation() override
Definition: flutter_window.cc:337
flutter::FlutterWindow::OnComposeChange
virtual void OnComposeChange(const std::u16string &text, int cursor_pos)
Definition: flutter_window.cc:277
flutter::WindowStateEvent::kShow
@ kShow
flutter::FlutterWindow::OnImeStartComposition
virtual void OnImeStartComposition(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:841
flutter::FlutterWindow::OnPaint
virtual void OnPaint()
Definition: flutter_window.cc:198
dpi_utils.h
flutter::FlutterWindow::OnSetCursor
virtual void OnSetCursor()
Definition: flutter_window.cc:246
flutter::WindowBindingHandlerDelegate::OnPointerLeave
virtual void OnPointerLeave(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id)=0
flutter::FlutterWindow::OnResetImeComposing
virtual void OnResetImeComposing() override
Definition: flutter_window.cc:307
flutter::FlutterWindow::OnWindowStateEvent
virtual void OnWindowStateEvent(WindowStateEvent event)
Definition: flutter_window.cc:362
flutter::Rect::height
double height() const
Definition: geometry.h:68
flutter::FlutterWindow::OnKey
virtual void OnKey(int key, int scancode, int action, char32_t character, bool extended, bool was_down, KeyEventCallback callback) override
Definition: flutter_window.cc:254
flutter
Definition: accessibility_bridge_windows.cc:11
flutter::WindowBindingHandlerDelegate::OnWindowStateEvent
virtual void OnWindowStateEvent(HWND hwnd, WindowStateEvent event)=0
flutter::FlutterWindow::OnResize
virtual void OnResize(unsigned int width, unsigned int height)
Definition: flutter_window.cc:192
flutter::WindowBindingHandlerDelegate::OnComposeBegin
virtual void OnComposeBegin()=0
flutter::FlutterWindow::Win32MapVkToChar
virtual uint32_t Win32MapVkToChar(uint32_t virtual_key) override
Definition: flutter_window.cc:468
flutter::WindowBindingHandlerDelegate::OnComposeEnd
virtual void OnComposeEnd()=0
flutter::kShift
constexpr int kShift
Definition: keyboard_utils.h:14
flutter::Rect::top
double top() const
Definition: geometry.h:64
flutter::WindowBindingHandlerDelegate::OnComposeCommit
virtual void OnComposeCommit()=0
flutter::FlutterWindow::GetAlertDelegate
virtual AlertPlatformNodeDelegate * GetAlertDelegate() override
Definition: flutter_window.cc:352
flutter::FlutterWindow::OnComposeCommit
virtual void OnComposeCommit()
Definition: flutter_window.cc:269
flutter_windows_engine.h
flutter::Point
Definition: geometry.h:13
flutter::FlutterWindow::HandleMessage
LRESULT HandleMessage(UINT const message, WPARAM const wparam, LPARAM const lparam) noexcept
Definition: flutter_window.cc:525
flutter::FlutterWindow::alert_node_
std::unique_ptr< ui::AXPlatformNodeWin > alert_node_
Definition: flutter_window.h:274
flutter::WindowBindingHandlerDelegate::OnPointerDown
virtual void OnPointerDown(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, FlutterPointerMouseButtons button)=0
flutter::FlutterWindow::OnImeRequest
virtual void OnImeRequest(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:890
flutter::WindowStateEvent::kUnfocus
@ kUnfocus
flutter::FlutterWindow::GetScrollOffsetMultiplier
virtual float GetScrollOffsetMultiplier()
Definition: flutter_window.cc:918
flutter::FlutterWindow::Win32DefWindowProc
virtual LRESULT Win32DefWindowProc(HWND hWnd, UINT Msg, WPARAM wParam, LPARAM lParam)
Definition: flutter_window.cc:922
flutter::FlutterWindow::OnScroll
virtual void OnScroll(double delta_x, double delta_y, FlutterPointerDeviceKind device_kind, int32_t device_id)
Definition: flutter_window.cc:286
flutter::FlutterWindow::OnImeComposition
virtual void OnImeComposition(UINT const message, WPARAM const wparam, LPARAM const lparam)
Definition: flutter_window.cc:848
flutter::FlutterWindow::OnComposeEnd
virtual void OnComposeEnd()
Definition: flutter_window.cc:273
flutter::FlutterWindow::GetPhysicalWindowBounds
virtual PhysicalWindowBounds GetPhysicalWindowBounds() override
Definition: flutter_window.cc:175
message
Win32Message message
Definition: keyboard_unittests.cc:137
action
int action
Definition: keyboard_key_handler_unittests.cc:116
flutter::WindowBindingHandlerDelegate::GetNativeViewAccessible
virtual gfx::NativeViewAccessible GetNativeViewAccessible()=0
flutter::WindowBindingHandlerDelegate::OnKey
virtual void OnKey(int key, int scancode, int action, char32_t character, bool extended, bool was_down, KeyEventCallback callback)=0
flutter::kControl
constexpr int kControl
Definition: keyboard_utils.h:15
flutter::FlutterWindow::alert_delegate_
std::unique_ptr< AlertPlatformNodeDelegate > alert_delegate_
Definition: flutter_window.h:271
flutter::WindowBindingHandlerDelegate::OnScroll
virtual void OnScroll(double x, double y, double delta_x, double delta_y, int scroll_offset_multiplier, FlutterPointerDeviceKind device_kind, int32_t device_id)=0
flutter::Size
Definition: geometry.h:33
flutter::FlutterWindow::IsVisible
virtual bool IsVisible() override
Definition: flutter_window.cc:171
key
int key
Definition: keyboard_key_handler_unittests.cc:114
flutter::WindowBindingHandlerDelegate::OnPointerUp
virtual void OnPointerUp(double x, double y, FlutterPointerDeviceKind device_kind, int32_t device_id, FlutterPointerMouseButtons button)=0
flutter::WindowBindingHandlerDelegate::OnComposeChange
virtual void OnComposeChange(const std::u16string &text, int cursor_pos)=0
flutter::WindowBindingHandlerDelegate::OnUpdateSemanticsEnabled
virtual void OnUpdateSemanticsEnabled(bool enabled)=0
flutter::WindowBindingHandlerDelegate::OnWindowSizeChanged
virtual void OnWindowSizeChanged(size_t width, size_t height)=0
flutter::FlutterWindow::OnDpiScale
virtual void OnDpiScale(unsigned int dpi)
Definition: flutter_window.cc:188
callback
FlutterDesktopBinaryReply callback
Definition: flutter_windows_view_unittests.cc:48
flutter::FlutterWindow::UpdateCursorRect
virtual void UpdateCursorRect(const Rect &rect)
Definition: flutter_window.cc:902