Flutter Windows Embedder
flutter::FlutterWindowsEngine Class Reference

#include <flutter_windows_engine.h>

Public Member Functions

 FlutterWindowsEngine (const FlutterProjectBundle &project, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr)
 
virtual ~FlutterWindowsEngine ()
 
bool Run ()
 
bool Run (std::string_view entrypoint)
 
virtual bool running () const
 
virtual bool Stop ()
 
std::unique_ptr< FlutterWindowsViewCreateView (std::unique_ptr< WindowBindingHandler > window, bool is_sized_to_content, const BoxConstraints &box_constraints, FlutterWindowsViewSizingDelegate *sizing_delegate=nullptr)
 
virtual void RemoveView (FlutterViewId view_id)
 
FlutterWindowsViewview (FlutterViewId view_id) const
 
FlutterDesktopPluginRegistrarRef GetRegistrar ()
 
void AddPluginRegistrarDestructionCallback (FlutterDesktopOnPluginRegistrarDestroyed callback, FlutterDesktopPluginRegistrarRef registrar)
 
void SetSwitches (const std::vector< std::string > &switches)
 
FlutterDesktopMessengerRef messenger ()
 
IncomingMessageDispatchermessage_dispatcher ()
 
std::shared_ptr< DisplayManagerWin32display_manager ()
 
void UpdateDisplay (const std::vector< FlutterEngineDisplay > &displays)
 
TaskRunnertask_runner ()
 
BinaryMessengermessenger_wrapper ()
 
FlutterWindowsTextureRegistrartexture_registrar ()
 
egl::Manageregl_manager () const
 
WindowProcDelegateManagerwindow_proc_delegate_manager ()
 
void SendWindowMetricsEvent (const FlutterWindowMetricsEvent &event)
 
void SendPointerEvent (const FlutterPointerEvent &event)
 
void SendKeyEvent (const FlutterKeyEvent &event, FlutterKeyEventCallback callback, void *user_data)
 
void SendViewFocusEvent (const FlutterViewFocusEvent &event)
 
KeyboardHandlerBasekeyboard_key_handler ()
 
TextInputPlugintext_input_plugin ()
 
bool SendPlatformMessage (const char *channel, const uint8_t *message, const size_t message_size, const FlutterDesktopBinaryReply reply, void *user_data)
 
void SendPlatformMessageResponse (const FlutterDesktopMessageResponseHandle *handle, const uint8_t *data, size_t data_length)
 
void HandlePlatformMessage (const FlutterPlatformMessage *)
 
void ReloadSystemFonts ()
 
void ScheduleFrame ()
 
void SetNextFrameCallback (fml::closure callback)
 
bool RegisterExternalTexture (int64_t texture_id)
 
bool UnregisterExternalTexture (int64_t texture_id)
 
bool MarkExternalTextureFrameAvailable (int64_t texture_id)
 
virtual bool PostRasterThreadTask (fml::closure callback) const
 
void OnVsync (intptr_t baton)
 
bool DispatchSemanticsAction (FlutterViewId view_id, uint64_t node_id, FlutterSemanticsAction action, fml::MallocMapping data)
 
void UpdateSemanticsEnabled (bool enabled)
 
bool semantics_enabled () const
 
void UpdateAccessibilityFeatures ()
 
void UpdateHighContrastMode ()
 
bool high_contrast_enabled () const
 
void SetRootIsolateCreateCallback (const fml::closure &callback)
 
std::string GetExecutableName () const
 
void OnQuit (std::optional< HWND > hwnd, std::optional< WPARAM > wparam, std::optional< LPARAM > lparam, UINT exit_code)
 
void RequestApplicationQuit (HWND hwnd, WPARAM wparam, LPARAM lparam, AppExitType exit_type)
 
void OnDwmCompositionChanged ()
 
void OnWindowStateEvent (HWND hwnd, WindowStateEvent event)
 
std::optional< LRESULT > ProcessExternalWindowMessage (HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam)
 
WindowsLifecycleManagerlifecycle_manager ()
 
std::shared_ptr< WindowsProcTablewindows_proc_table ()
 
void UpdateFlutterCursor (const std::string &cursor_name) const
 
void SetFlutterCursor (HCURSOR cursor) const
 
WindowManagerwindow_manager ()
 
FlutterWindowsViewGetViewFromTopLevelWindow (HWND hwnd) const
 

Static Public Member Functions

static FlutterWindowsEngineGetEngineForId (int64_t engine_id)
 

Protected Member Functions

virtual std::unique_ptr< KeyboardHandlerBaseCreateKeyboardKeyHandler (BinaryMessenger *messenger, KeyboardKeyEmbedderHandler::GetKeyStateHandler get_key_state, KeyboardKeyEmbedderHandler::MapVirtualKeyToScanCode map_vk_to_scan)
 
virtual std::unique_ptr< TextInputPluginCreateTextInputPlugin (BinaryMessenger *messenger)
 
void OnPreEngineRestart ()
 
virtual void OnChannelUpdate (std::string name, bool listening)
 
virtual void OnViewFocusChangeRequest (const FlutterViewFocusChangeRequest *request)
 

Friends

class EngineModifier
 

Detailed Description

Definition at line 92 of file flutter_windows_engine.h.

Constructor & Destructor Documentation

◆ FlutterWindowsEngine()

flutter::FlutterWindowsEngine::FlutterWindowsEngine ( const FlutterProjectBundle project,
std::shared_ptr< WindowsProcTable windows_proc_table = nullptr 
)

Definition at line 151 of file flutter_windows_engine.cc.

154  : project_(std::make_unique<FlutterProjectBundle>(project)),
155  windows_proc_table_(std::move(windows_proc_table)),
156  aot_data_(nullptr, nullptr),
157  lifecycle_manager_(std::make_unique<WindowsLifecycleManager>(this)) {
158  if (windows_proc_table_ == nullptr) {
159  windows_proc_table_ = std::make_shared<WindowsProcTable>();
160  }
161 
162  gl_ = egl::ProcTable::Create();
163 
164  embedder_api_.struct_size = sizeof(FlutterEngineProcTable);
165  FlutterEngineGetProcAddresses(&embedder_api_);
166 
167  task_runner_ =
168  std::make_unique<TaskRunner>(
169  embedder_api_.GetCurrentTime, [this](const auto* task) {
170  if (!engine_) {
171  FML_LOG(ERROR)
172  << "Cannot post an engine task when engine is not running.";
173  return;
174  }
175  if (embedder_api_.RunTask(engine_, task) != kSuccess) {
176  FML_LOG(ERROR) << "Failed to post an engine task.";
177  }
178  });
179 
180  // Set up the legacy structs backing the API handles.
181  messenger_ =
182  fml::RefPtr<FlutterDesktopMessenger>(new FlutterDesktopMessenger());
183  messenger_->SetEngine(this);
184  plugin_registrar_ = std::make_unique<FlutterDesktopPluginRegistrar>();
185  plugin_registrar_->engine = this;
186 
187  messenger_wrapper_ =
188  std::make_unique<BinaryMessengerImpl>(messenger_->ToRef());
189  message_dispatcher_ =
190  std::make_unique<IncomingMessageDispatcher>(messenger_->ToRef());
191 
192  texture_registrar_ =
193  std::make_unique<FlutterWindowsTextureRegistrar>(this, gl_);
194 
195  // Check for impeller support.
196  auto& switches = project_->GetSwitches();
197  enable_impeller_ = std::find(switches.begin(), switches.end(),
198  "--enable-impeller=true") != switches.end();
199 
200  egl_manager_ = egl::Manager::Create(
201  static_cast<egl::GpuPreference>(project_->gpu_preference()));
202  window_proc_delegate_manager_ = std::make_unique<WindowProcDelegateManager>();
203 
204  display_manager_ = std::make_shared<DisplayManagerWin32>(this);
205 
206  window_proc_delegate_manager_->RegisterTopLevelWindowProcDelegate(
207  [](HWND hwnd, UINT msg, WPARAM wpar, LPARAM lpar, void* user_data,
208  LRESULT* result) {
209  BASE_DCHECK(user_data);
210  FlutterWindowsEngine* that =
211  static_cast<FlutterWindowsEngine*>(user_data);
212 
213  BASE_DCHECK(that->display_manager_);
214  if (that->display_manager_->HandleWindowMessage(hwnd, msg, wpar, lpar,
215  result)) {
216  return true;
217  }
218 
219  BASE_DCHECK(that->lifecycle_manager_);
220  bool handled =
221  that->lifecycle_manager_->WindowProc(hwnd, msg, wpar, lpar, result);
222  if (handled) {
223  return true;
224  }
225  auto message_result =
226  that->window_manager_->HandleMessage(hwnd, msg, wpar, lpar);
227  if (message_result) {
228  *result = *message_result;
229  return true;
230  }
231  return false;
232  },
233  static_cast<void*>(this));
234 
235  // Set up internal channels.
236  // TODO: Replace this with an embedder.h API. See
237  // https://github.com/flutter/flutter/issues/71099
238  internal_plugin_registrar_ =
239  std::make_unique<PluginRegistrar>(plugin_registrar_.get());
240 
241  accessibility_plugin_ = std::make_unique<AccessibilityPlugin>(this);
242  AccessibilityPlugin::SetUp(messenger_wrapper_.get(),
243  accessibility_plugin_.get());
244 
245  cursor_handler_ =
246  std::make_unique<CursorHandler>(messenger_wrapper_.get(), this);
247  platform_handler_ =
248  std::make_unique<PlatformHandler>(messenger_wrapper_.get(), this);
249  window_manager_ = std::make_unique<WindowManager>(this);
250  settings_plugin_ = std::make_unique<SettingsPlugin>(messenger_wrapper_.get(),
251  task_runner_.get());
252 }
static void SetUp(BinaryMessenger *binary_messenger, AccessibilityPlugin *plugin)
std::shared_ptr< WindowsProcTable > windows_proc_table()
FlutterWindowsEngine(const FlutterProjectBundle &project, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr)
static std::unique_ptr< Manager > Create(GpuPreference gpu_preference)
Definition: manager.cc:17
static std::shared_ptr< ProcTable > Create()
Definition: proc_table.cc:12

References flutter::egl::ProcTable::Create().

◆ ~FlutterWindowsEngine()

flutter::FlutterWindowsEngine::~FlutterWindowsEngine ( )
virtual

Definition at line 254 of file flutter_windows_engine.cc.

254  {
255  messenger_->SetEngine(nullptr);
256  Stop();
257 }

Member Function Documentation

◆ AddPluginRegistrarDestructionCallback()

void flutter::FlutterWindowsEngine::AddPluginRegistrarDestructionCallback ( FlutterDesktopOnPluginRegistrarDestroyed  callback,
FlutterDesktopPluginRegistrarRef  registrar 
)

Definition at line 708 of file flutter_windows_engine.cc.

710  {
711  plugin_registrar_destruction_callbacks_[callback] = registrar;
712 }
FlutterDesktopBinaryReply callback

References callback.

Referenced by FlutterDesktopPluginRegistrarSetDestructionHandler().

◆ CreateKeyboardKeyHandler()

std::unique_ptr< KeyboardHandlerBase > flutter::FlutterWindowsEngine::CreateKeyboardKeyHandler ( BinaryMessenger messenger,
KeyboardKeyEmbedderHandler::GetKeyStateHandler  get_key_state,
KeyboardKeyEmbedderHandler::MapVirtualKeyToScanCode  map_vk_to_scan 
)
protectedvirtual

Definition at line 915 of file flutter_windows_engine.cc.

918  {
919  auto keyboard_key_handler = std::make_unique<KeyboardKeyHandler>(messenger);
920  keyboard_key_handler->AddDelegate(
921  std::make_unique<KeyboardKeyEmbedderHandler>(
922  [this](const FlutterKeyEvent& event, FlutterKeyEventCallback callback,
923  void* user_data) {
924  return SendKeyEvent(event, callback, user_data);
925  },
926  get_key_state, map_vk_to_scan));
927  keyboard_key_handler->AddDelegate(
928  std::make_unique<KeyboardKeyChannelHandler>(messenger));
929  keyboard_key_handler->InitKeyboardChannel();
930  return keyboard_key_handler;
931 }
FlutterDesktopMessengerRef messenger()
KeyboardHandlerBase * keyboard_key_handler()
void SendKeyEvent(const FlutterKeyEvent &event, FlutterKeyEventCallback callback, void *user_data)

References callback, and user_data.

◆ CreateTextInputPlugin()

std::unique_ptr< TextInputPlugin > flutter::FlutterWindowsEngine::CreateTextInputPlugin ( BinaryMessenger messenger)
protectedvirtual

Definition at line 933 of file flutter_windows_engine.cc.

934  {
935  return std::make_unique<TextInputPlugin>(messenger, this);
936 }

◆ CreateView()

std::unique_ptr< FlutterWindowsView > flutter::FlutterWindowsEngine::CreateView ( std::unique_ptr< WindowBindingHandler window,
bool  is_sized_to_content,
const BoxConstraints &  box_constraints,
FlutterWindowsViewSizingDelegate sizing_delegate = nullptr 
)

Definition at line 526 of file flutter_windows_engine.cc.

530  {
531  auto view_id = next_view_id_;
532  auto view = std::make_unique<FlutterWindowsView>(
533  view_id, this, std::move(window), is_sized_to_content, box_constraints,
534  sizing_delegate, windows_proc_table_);
535 
537  view->UpdateSemanticsEnabled(semantics_enabled_);
538 
539  next_view_id_++;
540 
541  {
542  // Add the view to the embedder. This must happen before the engine
543  // is notified the view exists and starts presenting to it.
544  std::unique_lock write_lock(views_mutex_);
545  FML_DCHECK(views_.find(view_id) == views_.end());
546  views_[view_id] = view.get();
547  }
548 
549  if (!view->IsImplicitView()) {
550  FML_DCHECK(running());
551 
552  struct Captures {
553  fml::AutoResetWaitableEvent latch;
554  bool added;
555  };
556  Captures captures = {};
557 
558  FlutterWindowMetricsEvent metrics = view->CreateWindowMetricsEvent();
559 
560  FlutterAddViewInfo info = {};
561  info.struct_size = sizeof(FlutterAddViewInfo);
562  info.view_id = view_id;
563  info.view_metrics = &metrics;
564  info.user_data = &captures;
565  info.add_view_callback = [](const FlutterAddViewResult* result) {
566  Captures* captures = reinterpret_cast<Captures*>(result->user_data);
567  captures->added = result->added;
568  captures->latch.Signal();
569  };
570 
571  FlutterEngineResult result = embedder_api_.AddView(engine_, &info);
572  if (result != kSuccess) {
573  FML_LOG(ERROR)
574  << "Starting the add view operation failed. FlutterEngineAddView "
575  "returned an unexpected result: "
576  << result << ". This indicates a bug in the Windows embedder.";
577  FML_DCHECK(false);
578  return nullptr;
579  }
580 
581  // Block the platform thread until the engine has added the view.
582  // TODO(loicsharma): This blocks the platform thread eagerly and can
583  // cause unnecessary delay in input processing. Instead, this should block
584  // lazily only when the app does an operation which needs the view.
585  // https://github.com/flutter/flutter/issues/146248
586  captures.latch.Wait();
587 
588  if (!captures.added) {
589  // Adding the view failed. Update the embedder's state to match the
590  // engine's state. This is unexpected and indicates a bug in the Windows
591  // embedder.
592  FML_LOG(ERROR) << "FlutterEngineAddView failed to add view";
593  std::unique_lock write_lock(views_mutex_);
594  views_.erase(view_id);
595  return nullptr;
596  }
597  }
598 
599  return std::move(view);
600 }
FlutterWindowsView * view(FlutterViewId view_id) const
virtual void UpdateSemanticsEnabled(bool enabled)
FlutterWindowMetricsEvent CreateWindowMetricsEvent() const

Referenced by CreateViewController(), flutter::HostWindow::InitializeFlutterView(), and flutter::testing::TEST_F().

◆ DispatchSemanticsAction()

bool flutter::FlutterWindowsEngine::DispatchSemanticsAction ( FlutterViewId  view_id,
uint64_t  node_id,
FlutterSemanticsAction  action,
fml::MallocMapping  data 
)

Definition at line 974 of file flutter_windows_engine.cc.

978  {
979  FlutterSendSemanticsActionInfo info{
980  .struct_size = sizeof(FlutterSendSemanticsActionInfo),
981  .view_id = view_id,
982  .node_id = target,
983  .action = action,
984  .data = data.GetMapping(),
985  .data_length = data.GetSize(),
986  };
987  return (embedder_api_.SendSemanticsAction(engine_, &info));
988 }

References action.

Referenced by flutter::AccessibilityBridgeWindows::DispatchAccessibilityAction().

◆ display_manager()

std::shared_ptr<DisplayManagerWin32> flutter::FlutterWindowsEngine::display_manager ( )
inline

Definition at line 166 of file flutter_windows_engine.h.

166  {
167  return display_manager_;
168  }

Referenced by CreateViewController(), flutter::HostWindow::InitializeFlutterView(), and flutter::HostWindow::SetFullscreen().

◆ egl_manager()

◆ GetEngineForId()

◆ GetExecutableName()

std::string flutter::FlutterWindowsEngine::GetExecutableName ( ) const

Definition at line 1007 of file flutter_windows_engine.cc.

1007  {
1008  std::pair<bool, std::string> result = fml::paths::GetExecutablePath();
1009  if (result.first) {
1010  const std::string& executable_path = result.second;
1011  size_t last_separator = executable_path.find_last_of("/\\");
1012  if (last_separator == std::string::npos ||
1013  last_separator == executable_path.size() - 1) {
1014  return executable_path;
1015  }
1016  return executable_path.substr(last_separator + 1);
1017  }
1018  return "Flutter";
1019 }

◆ GetRegistrar()

FlutterDesktopPluginRegistrarRef flutter::FlutterWindowsEngine::GetRegistrar ( )

Definition at line 704 of file flutter_windows_engine.cc.

704  {
705  return plugin_registrar_.get();
706 }

Referenced by FlutterDesktopEngineGetPluginRegistrar().

◆ GetViewFromTopLevelWindow()

FlutterWindowsView * flutter::FlutterWindowsEngine::GetViewFromTopLevelWindow ( HWND  hwnd) const

Definition at line 868 of file flutter_windows_engine.cc.

869  {
870  std::shared_lock read_lock(views_mutex_);
871  auto const iterator =
872  std::find_if(views_.begin(), views_.end(), [hwnd](auto const& pair) {
873  FlutterWindowsView* const view = pair.second;
874  return GetAncestor(view->GetWindowHandle(), GA_ROOT) == hwnd;
875  });
876  if (iterator != views_.end()) {
877  return iterator->second;
878  }
879  return nullptr;
880 }

◆ HandlePlatformMessage()

void flutter::FlutterWindowsEngine::HandlePlatformMessage ( const FlutterPlatformMessage *  engine_message)

Definition at line 792 of file flutter_windows_engine.cc.

793  {
794  if (engine_message->struct_size != sizeof(FlutterPlatformMessage)) {
795  FML_LOG(ERROR) << "Invalid message size received. Expected: "
796  << sizeof(FlutterPlatformMessage) << " but received "
797  << engine_message->struct_size;
798  return;
799  }
800 
801  auto message = ConvertToDesktopMessage(*engine_message);
802 
803  message_dispatcher_->HandleMessage(message, [this] {}, [this] {});
804 }
Win32Message message

References message.

Referenced by Run().

◆ high_contrast_enabled()

bool flutter::FlutterWindowsEngine::high_contrast_enabled ( ) const
inline

Definition at line 270 of file flutter_windows_engine.h.

270 { return high_contrast_enabled_; }

◆ keyboard_key_handler()

KeyboardHandlerBase* flutter::FlutterWindowsEngine::keyboard_key_handler ( )
inline

Definition at line 203 of file flutter_windows_engine.h.

203  {
204  return keyboard_key_handler_.get();
205  }

Referenced by flutter::FlutterWindowsView::OnPointerMove().

◆ lifecycle_manager()

WindowsLifecycleManager* flutter::FlutterWindowsEngine::lifecycle_manager ( )
inline

Definition at line 315 of file flutter_windows_engine.h.

315  {
316  return lifecycle_manager_.get();
317  }

◆ MarkExternalTextureFrameAvailable()

bool flutter::FlutterWindowsEngine::MarkExternalTextureFrameAvailable ( int64_t  texture_id)

Definition at line 948 of file flutter_windows_engine.cc.

949  {
950  return (embedder_api_.MarkExternalTextureFrameAvailable(
951  engine_, texture_id) == kSuccess);
952 }
uint32_t texture_id

◆ message_dispatcher()

IncomingMessageDispatcher* flutter::FlutterWindowsEngine::message_dispatcher ( )
inline

Definition at line 162 of file flutter_windows_engine.h.

162  {
163  return message_dispatcher_.get();
164  }

Referenced by FlutterDesktopMessengerSetCallback().

◆ messenger()

FlutterDesktopMessengerRef flutter::FlutterWindowsEngine::messenger ( )
inline

Definition at line 160 of file flutter_windows_engine.h.

160 { return messenger_->ToRef(); }

Referenced by FlutterDesktopEngineGetMessenger(), and FlutterDesktopPluginRegistrarGetMessenger().

◆ messenger_wrapper()

BinaryMessenger* flutter::FlutterWindowsEngine::messenger_wrapper ( )
inline

Definition at line 175 of file flutter_windows_engine.h.

175 { return messenger_wrapper_.get(); }

◆ OnChannelUpdate()

void flutter::FlutterWindowsEngine::OnChannelUpdate ( std::string  name,
bool  listening 
)
protectedvirtual

Definition at line 1095 of file flutter_windows_engine.cc.

1095  {
1096  if (name == "flutter/platform" && listening) {
1097  lifecycle_manager_->BeginProcessingExit();
1098  } else if (name == "flutter/lifecycle" && listening) {
1099  lifecycle_manager_->BeginProcessingLifecycle();
1100  }
1101 }

◆ OnDwmCompositionChanged()

void flutter::FlutterWindowsEngine::OnDwmCompositionChanged ( )

Definition at line 1058 of file flutter_windows_engine.cc.

1058  {
1059  if (display_manager_) {
1060  display_manager_->UpdateDisplays();
1061  }
1062 
1063  std::shared_lock read_lock(views_mutex_);
1064  for (auto iterator = views_.begin(); iterator != views_.end(); iterator++) {
1065  iterator->second->OnDwmCompositionChanged();
1066  }
1067 }

Referenced by flutter::WindowsLifecycleManager::WindowProc().

◆ OnPreEngineRestart()

void flutter::FlutterWindowsEngine::OnPreEngineRestart ( )
protected

Definition at line 1002 of file flutter_windows_engine.cc.

1002  {
1003  // Reset the keyboard's state on hot restart.
1004  InitializeKeyboard();
1005 }

Referenced by Run().

◆ OnQuit()

void flutter::FlutterWindowsEngine::OnQuit ( std::optional< HWND >  hwnd,
std::optional< WPARAM >  wparam,
std::optional< LPARAM >  lparam,
UINT  exit_code 
)

Definition at line 1051 of file flutter_windows_engine.cc.

1054  {
1055  lifecycle_manager_->Quit(hwnd, wparam, lparam, exit_code);
1056 }

Referenced by flutter::PlatformHandler::QuitApplication().

◆ OnViewFocusChangeRequest()

void flutter::FlutterWindowsEngine::OnViewFocusChangeRequest ( const FlutterViewFocusChangeRequest *  request)
protectedvirtual

Definition at line 1103 of file flutter_windows_engine.cc.

1104  {
1105  std::shared_lock read_lock(views_mutex_);
1106 
1107  auto iterator = views_.find(request->view_id);
1108  if (iterator == views_.end()) {
1109  return;
1110  }
1111 
1112  FlutterWindowsView* view = iterator->second;
1113  view->Focus();
1114 }

References flutter::FlutterWindowsView::Focus().

Referenced by Run().

◆ OnVsync()

void flutter::FlutterWindowsEngine::OnVsync ( intptr_t  baton)

Definition at line 664 of file flutter_windows_engine.cc.

664  {
665  std::chrono::nanoseconds current_time =
666  std::chrono::nanoseconds(embedder_api_.GetCurrentTime());
667  std::chrono::nanoseconds frame_interval = FrameInterval();
668  auto next = SnapToNextTick(current_time, start_time_, frame_interval);
669  embedder_api_.OnVsync(engine_, baton, next.count(),
670  (next + frame_interval).count());
671 }

Referenced by Run().

◆ OnWindowStateEvent()

void flutter::FlutterWindowsEngine::OnWindowStateEvent ( HWND  hwnd,
WindowStateEvent  event 
)

Definition at line 1069 of file flutter_windows_engine.cc.

1070  {
1071  lifecycle_manager_->OnWindowStateEvent(hwnd, event);
1072 }

Referenced by flutter::FlutterWindowsView::OnWindowStateEvent(), and flutter::FlutterWindowsView::~FlutterWindowsView().

◆ PostRasterThreadTask()

bool flutter::FlutterWindowsEngine::PostRasterThreadTask ( fml::closure  callback) const
virtual

Definition at line 954 of file flutter_windows_engine.cc.

954  {
955  struct Captures {
956  fml::closure callback;
957  };
958  auto captures = new Captures();
959  captures->callback = std::move(callback);
960  if (embedder_api_.PostRenderThreadTask(
961  engine_,
962  [](void* opaque) {
963  auto captures = reinterpret_cast<Captures*>(opaque);
964  captures->callback();
965  delete captures;
966  },
967  captures) == kSuccess) {
968  return true;
969  }
970  delete captures;
971  return false;
972 }

References callback.

Referenced by flutter::FlutterWindowsTextureRegistrar::UnregisterTexture().

◆ ProcessExternalWindowMessage()

std::optional< LRESULT > flutter::FlutterWindowsEngine::ProcessExternalWindowMessage ( HWND  hwnd,
UINT  message,
WPARAM  wparam,
LPARAM  lparam 
)

Definition at line 1074 of file flutter_windows_engine.cc.

1078  {
1079  if (lifecycle_manager_) {
1080  return lifecycle_manager_->ExternalWindowMessage(hwnd, message, wparam,
1081  lparam);
1082  }
1083  return std::nullopt;
1084 }

References message.

Referenced by FlutterDesktopEngineProcessExternalWindowMessage().

◆ RegisterExternalTexture()

bool flutter::FlutterWindowsEngine::RegisterExternalTexture ( int64_t  texture_id)

Definition at line 938 of file flutter_windows_engine.cc.

938  {
939  return (embedder_api_.RegisterExternalTexture(engine_, texture_id) ==
940  kSuccess);
941 }

◆ ReloadSystemFonts()

void flutter::FlutterWindowsEngine::ReloadSystemFonts ( )

Definition at line 806 of file flutter_windows_engine.cc.

806  {
807  embedder_api_.ReloadSystemFonts(engine_);
808 }

Referenced by FlutterDesktopEngineReloadSystemFonts().

◆ RemoveView()

void flutter::FlutterWindowsEngine::RemoveView ( FlutterViewId  view_id)
virtual

Definition at line 602 of file flutter_windows_engine.cc.

602  {
603  FML_DCHECK(running());
604 
605  // Notify the engine to stop rendering to the view if it isn't the implicit
606  // view. The engine and framework assume the implicit view always exists and
607  // can continue presenting.
608  if (view_id != kImplicitViewId) {
609  struct Captures {
610  fml::AutoResetWaitableEvent latch;
611  bool removed;
612  };
613  Captures captures = {};
614 
615  FlutterRemoveViewInfo info = {};
616  info.struct_size = sizeof(FlutterRemoveViewInfo);
617  info.view_id = view_id;
618  info.user_data = &captures;
619  info.remove_view_callback = [](const FlutterRemoveViewResult* result) {
620  // This is invoked on an engine thread. If
621  // |FlutterRemoveViewResult.removed| is `true`, the engine guarantees the
622  // view won't be presented.
623  Captures* captures = reinterpret_cast<Captures*>(result->user_data);
624  captures->removed = result->removed;
625  captures->latch.Signal();
626  };
627 
628  FlutterEngineResult result = embedder_api_.RemoveView(engine_, &info);
629  if (result != kSuccess) {
630  FML_LOG(ERROR) << "Starting the remove view operation failed. "
631  "FlutterEngineRemoveView "
632  "returned an unexpected result: "
633  << result
634  << ". This indicates a bug in the Windows embedder.";
635  FML_DCHECK(false);
636  return;
637  }
638 
639  // Block the platform thread until the engine has removed the view.
640  // TODO(loicsharma): This blocks the platform thread eagerly and can
641  // cause unnecessary delay in input processing. Instead, this should block
642  // lazily only when an operation needs the view.
643  // https://github.com/flutter/flutter/issues/146248
644  captures.latch.Wait();
645 
646  if (!captures.removed) {
647  // Removing the view failed. This is unexpected and indicates a bug in the
648  // Windows embedder.
649  FML_LOG(ERROR) << "FlutterEngineRemoveView failed to remove view";
650  return;
651  }
652  }
653 
654  {
655  // The engine no longer presents to the view. Remove the view from the
656  // embedder.
657  std::unique_lock write_lock(views_mutex_);
658 
659  FML_DCHECK(views_.find(view_id) != views_.end());
660  views_.erase(view_id);
661  }
662 }
constexpr FlutterViewId kImplicitViewId

References flutter::kImplicitViewId.

◆ RequestApplicationQuit()

void flutter::FlutterWindowsEngine::RequestApplicationQuit ( HWND  hwnd,
WPARAM  wparam,
LPARAM  lparam,
AppExitType  exit_type 
)

Definition at line 1044 of file flutter_windows_engine.cc.

1047  {
1048  platform_handler_->RequestAppExit(hwnd, wparam, lparam, exit_type, 0);
1049 }

◆ Run() [1/2]

bool flutter::FlutterWindowsEngine::Run ( )

Definition at line 268 of file flutter_windows_engine.cc.

268  {
269  return Run("");
270 }

Referenced by FlutterDesktopEngineRun().

◆ Run() [2/2]

bool flutter::FlutterWindowsEngine::Run ( std::string_view  entrypoint)

Definition at line 272 of file flutter_windows_engine.cc.

272  {
273  if (!project_->HasValidPaths()) {
274  FML_LOG(ERROR) << "Missing or unresolvable paths to assets.";
275  return false;
276  }
277  std::string assets_path_string = fml::PathToUtf8(project_->assets_path());
278  std::string icu_path_string = fml::PathToUtf8(project_->icu_path());
279  if (embedder_api_.RunsAOTCompiledDartCode()) {
280  aot_data_ = project_->LoadAotData(embedder_api_);
281  if (!aot_data_) {
282  FML_LOG(ERROR) << "Unable to start engine without AOT data.";
283  return false;
284  }
285  }
286 
287  // FlutterProjectArgs is expecting a full argv, so when processing it for
288  // flags the first item is treated as the executable and ignored. Add a dummy
289  // value so that all provided arguments are used.
290  std::string executable_name = GetExecutableName();
291  std::vector<const char*> argv = {executable_name.c_str()};
292  std::vector<std::string> switches = project_->GetSwitches();
293  std::transform(
294  switches.begin(), switches.end(), std::back_inserter(argv),
295  [](const std::string& arg) -> const char* { return arg.c_str(); });
296 
297  const std::vector<std::string>& entrypoint_args =
298  project_->dart_entrypoint_arguments();
299  std::vector<const char*> entrypoint_argv;
300  std::transform(
301  entrypoint_args.begin(), entrypoint_args.end(),
302  std::back_inserter(entrypoint_argv),
303  [](const std::string& arg) -> const char* { return arg.c_str(); });
304 
305  // Configure task runners.
306  FlutterTaskRunnerDescription platform_task_runner = {};
307  platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
308  platform_task_runner.user_data = task_runner_.get();
309  platform_task_runner.runs_task_on_current_thread_callback =
310  [](void* user_data) -> bool {
311  return static_cast<TaskRunner*>(user_data)->RunsTasksOnCurrentThread();
312  };
313  platform_task_runner.post_task_callback = [](FlutterTask task,
314  uint64_t target_time_nanos,
315  void* user_data) -> void {
316  static_cast<TaskRunner*>(user_data)->PostFlutterTask(task,
317  target_time_nanos);
318  };
319  FlutterCustomTaskRunners custom_task_runners = {};
320  custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
321  custom_task_runners.platform_task_runner = &platform_task_runner;
322  custom_task_runners.thread_priority_setter =
324 
325  if (project_->ui_thread_policy() !=
327  custom_task_runners.ui_task_runner = &platform_task_runner;
328  } else {
329  FML_LOG(WARNING) << "Running with unmerged platform and UI threads. This "
330  "will be removed in future.";
331  }
332 
333  FlutterProjectArgs args = {};
334  args.struct_size = sizeof(FlutterProjectArgs);
335  args.shutdown_dart_vm_when_done = true;
336  args.assets_path = assets_path_string.c_str();
337  args.icu_data_path = icu_path_string.c_str();
338  args.command_line_argc = static_cast<int>(argv.size());
339  args.command_line_argv = argv.empty() ? nullptr : argv.data();
340  args.engine_id = reinterpret_cast<int64_t>(this);
341 
342  // Fail if conflicting non-default entrypoints are specified in the method
343  // argument and the project.
344  //
345  // TODO(cbracken): https://github.com/flutter/flutter/issues/109285
346  // The entrypoint method parameter should eventually be removed from this
347  // method and only the entrypoint specified in project_ should be used.
348  if (!project_->dart_entrypoint().empty() && !entrypoint.empty() &&
349  project_->dart_entrypoint() != entrypoint) {
350  FML_LOG(ERROR) << "Conflicting entrypoints were specified in "
351  "FlutterDesktopEngineProperties.dart_entrypoint and "
352  "FlutterDesktopEngineRun(engine, entry_point). ";
353  return false;
354  }
355  if (!entrypoint.empty()) {
356  args.custom_dart_entrypoint = entrypoint.data();
357  } else if (!project_->dart_entrypoint().empty()) {
358  args.custom_dart_entrypoint = project_->dart_entrypoint().c_str();
359  }
360  args.dart_entrypoint_argc = static_cast<int>(entrypoint_argv.size());
361  args.dart_entrypoint_argv =
362  entrypoint_argv.empty() ? nullptr : entrypoint_argv.data();
363  args.platform_message_callback =
364  [](const FlutterPlatformMessage* engine_message,
365  void* user_data) -> void {
366  auto host = static_cast<FlutterWindowsEngine*>(user_data);
367  return host->HandlePlatformMessage(engine_message);
368  };
369  args.vsync_callback = [](void* user_data, intptr_t baton) -> void {
370  auto host = static_cast<FlutterWindowsEngine*>(user_data);
371  host->OnVsync(baton);
372  };
373  args.on_pre_engine_restart_callback = [](void* user_data) {
374  auto host = static_cast<FlutterWindowsEngine*>(user_data);
375  host->OnPreEngineRestart();
376  };
377  args.update_semantics_callback2 = [](const FlutterSemanticsUpdate2* update,
378  void* user_data) {
379  auto host = static_cast<FlutterWindowsEngine*>(user_data);
380 
381  auto view = host->view(update->view_id);
382  if (!view) {
383  return;
384  }
385 
386  auto accessibility_bridge = view->accessibility_bridge().lock();
387  if (!accessibility_bridge) {
388  return;
389  }
390 
391  for (size_t i = 0; i < update->node_count; i++) {
392  const FlutterSemanticsNode2* node = update->nodes[i];
393  accessibility_bridge->AddFlutterSemanticsNodeUpdate(*node);
394  }
395 
396  for (size_t i = 0; i < update->custom_action_count; i++) {
397  const FlutterSemanticsCustomAction2* action = update->custom_actions[i];
398  accessibility_bridge->AddFlutterSemanticsCustomActionUpdate(*action);
399  }
400 
401  accessibility_bridge->CommitUpdates();
402  };
403  args.root_isolate_create_callback = [](void* user_data) {
404  auto host = static_cast<FlutterWindowsEngine*>(user_data);
405  if (host->root_isolate_create_callback_) {
406  host->root_isolate_create_callback_();
407  }
408  };
409  args.channel_update_callback = [](const FlutterChannelUpdate* update,
410  void* user_data) {
411  auto host = static_cast<FlutterWindowsEngine*>(user_data);
412  if (SAFE_ACCESS(update, channel, nullptr) != nullptr) {
413  std::string channel_name(update->channel);
414  host->OnChannelUpdate(std::move(channel_name),
415  SAFE_ACCESS(update, listening, false));
416  }
417  };
418  args.view_focus_change_request_callback =
419  [](const FlutterViewFocusChangeRequest* request, void* user_data) {
420  auto host = static_cast<FlutterWindowsEngine*>(user_data);
421  host->OnViewFocusChangeRequest(request);
422  };
423 
424  args.custom_task_runners = &custom_task_runners;
425 
426  if (!platform_view_plugin_) {
427  platform_view_plugin_ = std::make_unique<PlatformViewPlugin>(
428  messenger_wrapper_.get(), task_runner_.get());
429  }
430  if (egl_manager_) {
431  auto resolver = [](const char* name) -> void* {
432  return reinterpret_cast<void*>(::eglGetProcAddress(name));
433  };
434 
435  // TODO(schectman) Pass the platform view manager to the compositor
436  // constructors: https://github.com/flutter/flutter/issues/143375
437  compositor_ =
438  std::make_unique<CompositorOpenGL>(this, resolver, enable_impeller_);
439  } else {
440  compositor_ = std::make_unique<CompositorSoftware>();
441  }
442 
443  FlutterCompositor compositor = {};
444  compositor.struct_size = sizeof(FlutterCompositor);
445  compositor.user_data = this;
446  compositor.create_backing_store_callback =
447  [](const FlutterBackingStoreConfig* config,
448  FlutterBackingStore* backing_store_out, void* user_data) -> bool {
449  auto host = static_cast<FlutterWindowsEngine*>(user_data);
450 
451  return host->compositor_->CreateBackingStore(*config, backing_store_out);
452  };
453 
454  compositor.collect_backing_store_callback =
455  [](const FlutterBackingStore* backing_store, void* user_data) -> bool {
456  auto host = static_cast<FlutterWindowsEngine*>(user_data);
457 
458  return host->compositor_->CollectBackingStore(backing_store);
459  };
460 
461  compositor.present_view_callback =
462  [](const FlutterPresentViewInfo* info) -> bool {
463  auto host = static_cast<FlutterWindowsEngine*>(info->user_data);
464 
465  return host->Present(info);
466  };
467  args.compositor = &compositor;
468 
469  if (aot_data_) {
470  args.aot_data = aot_data_.get();
471  }
472 
473  // The platform thread creates OpenGL contexts. These
474  // must be released to be used by the engine's threads.
475  FML_DCHECK(!egl_manager_ || !egl_manager_->HasContextCurrent());
476 
477  FlutterRendererConfig renderer_config;
478 
479  if (enable_impeller_) {
480  // Impeller does not support a Software backend. Avoid falling back and
481  // confusing the engine on which renderer is selected.
482  if (!egl_manager_) {
483  FML_LOG(ERROR) << "Could not create surface manager. Impeller backend "
484  "does not support software rendering.";
485  return false;
486  }
487  renderer_config = GetOpenGLRendererConfig();
488  } else {
489  renderer_config =
490  egl_manager_ ? GetOpenGLRendererConfig() : GetSoftwareRendererConfig();
491  }
492 
493  auto result = embedder_api_.Run(FLUTTER_ENGINE_VERSION, &renderer_config,
494  &args, this, &engine_);
495  if (result != kSuccess || engine_ == nullptr) {
496  FML_LOG(ERROR) << "Failed to start Flutter engine: error " << result;
497  return false;
498  }
499 
500  display_manager_->UpdateDisplays();
501 
502  SendSystemLocales();
503 
504  settings_plugin_->StartWatching();
505  settings_plugin_->SendSettings();
506 
507  InitializeKeyboard();
508 
509  return true;
510 }
std::weak_ptr< AccessibilityBridgeWindows > accessibility_bridge()
static void WindowsPlatformThreadPrioritySetter(FlutterThreadPriority priority)

References flutter::FlutterWindowsView::accessibility_bridge(), action, HandlePlatformMessage(), OnPreEngineRestart(), OnViewFocusChangeRequest(), OnVsync(), RunOnSeparateThread, user_data, view(), and flutter::WindowsPlatformThreadPrioritySetter().

◆ running()

virtual bool flutter::FlutterWindowsEngine::running ( ) const
inlinevirtual

Definition at line 125 of file flutter_windows_engine.h.

125 { return engine_ != nullptr; }

Referenced by FlutterDesktopEngineDestroy(), and flutter::HostWindow::InitializeFlutterView().

◆ ScheduleFrame()

void flutter::FlutterWindowsEngine::ScheduleFrame ( )

Definition at line 810 of file flutter_windows_engine.cc.

810  {
811  embedder_api_.ScheduleFrame(engine_);
812 }

Referenced by flutter::FlutterWindowsView::ForceRedraw().

◆ semantics_enabled()

bool flutter::FlutterWindowsEngine::semantics_enabled ( ) const
inline

Definition at line 261 of file flutter_windows_engine.h.

261 { return semantics_enabled_; }

Referenced by flutter::AccessibilityPlugin::Announce().

◆ SendKeyEvent()

void flutter::FlutterWindowsEngine::SendKeyEvent ( const FlutterKeyEvent &  event,
FlutterKeyEventCallback  callback,
void *  user_data 
)

Definition at line 736 of file flutter_windows_engine.cc.

738  {
739  if (engine_) {
740  embedder_api_.SendKeyEvent(engine_, &event, callback, user_data);
741  }
742 }

◆ SendPlatformMessage()

bool flutter::FlutterWindowsEngine::SendPlatformMessage ( const char *  channel,
const uint8_t *  message,
const size_t  message_size,
const FlutterDesktopBinaryReply  reply,
void *  user_data 
)

Definition at line 751 of file flutter_windows_engine.cc.

756  {
757  FlutterPlatformMessageResponseHandle* response_handle = nullptr;
758  if (reply != nullptr && user_data != nullptr) {
759  FlutterEngineResult result =
760  embedder_api_.PlatformMessageCreateResponseHandle(
761  engine_, reply, user_data, &response_handle);
762  if (result != kSuccess) {
763  FML_LOG(ERROR) << "Failed to create response handle";
764  return false;
765  }
766  }
767 
768  FlutterPlatformMessage platform_message = {
769  sizeof(FlutterPlatformMessage),
770  channel,
771  message,
772  message_size,
773  response_handle,
774  };
775 
776  FlutterEngineResult message_result =
777  embedder_api_.SendPlatformMessage(engine_, &platform_message);
778  if (response_handle != nullptr) {
779  embedder_api_.PlatformMessageReleaseResponseHandle(engine_,
780  response_handle);
781  }
782  return message_result == kSuccess;
783 }

References user_data.

Referenced by FlutterDesktopMessengerSendWithReply().

◆ SendPlatformMessageResponse()

void flutter::FlutterWindowsEngine::SendPlatformMessageResponse ( const FlutterDesktopMessageResponseHandle handle,
const uint8_t *  data,
size_t  data_length 
)

Definition at line 785 of file flutter_windows_engine.cc.

788  {
789  embedder_api_.SendPlatformMessageResponse(engine_, handle, data, data_length);
790 }

Referenced by FlutterDesktopMessengerSendResponse().

◆ SendPointerEvent()

void flutter::FlutterWindowsEngine::SendPointerEvent ( const FlutterPointerEvent &  event)

Definition at line 730 of file flutter_windows_engine.cc.

730  {
731  if (engine_) {
732  embedder_api_.SendPointerEvent(engine_, &event, 1);
733  }
734 }

◆ SendViewFocusEvent()

void flutter::FlutterWindowsEngine::SendViewFocusEvent ( const FlutterViewFocusEvent &  event)

Definition at line 744 of file flutter_windows_engine.cc.

745  {
746  if (engine_) {
747  embedder_api_.SendViewFocusEvent(engine_, &event);
748  }
749 }

◆ SendWindowMetricsEvent()

void flutter::FlutterWindowsEngine::SendWindowMetricsEvent ( const FlutterWindowMetricsEvent &  event)

Definition at line 723 of file flutter_windows_engine.cc.

724  {
725  if (engine_) {
726  embedder_api_.SendWindowMetricsEvent(engine_, &event);
727  }
728 }

Referenced by flutter::FlutterWindowsView::SendInitialBounds().

◆ SetFlutterCursor()

void flutter::FlutterWindowsEngine::SetFlutterCursor ( HCURSOR  cursor) const

Definition at line 1091 of file flutter_windows_engine.cc.

1091  {
1092  windows_proc_table_->SetCursor(cursor);
1093 }

◆ SetNextFrameCallback()

void flutter::FlutterWindowsEngine::SetNextFrameCallback ( fml::closure  callback)

Definition at line 814 of file flutter_windows_engine.cc.

814  {
815  next_frame_callback_ = std::move(callback);
816 
817  embedder_api_.SetNextFrameCallback(
818  engine_,
819  [](void* user_data) {
820  // Embedder callback runs on raster thread. Switch back to platform
821  // thread.
822  FlutterWindowsEngine* self =
823  static_cast<FlutterWindowsEngine*>(user_data);
824 
825  self->task_runner_->PostTask(std::move(self->next_frame_callback_));
826  },
827  this);
828 }

Referenced by FlutterDesktopEngineSetNextFrameCallback().

◆ SetRootIsolateCreateCallback()

void flutter::FlutterWindowsEngine::SetRootIsolateCreateCallback ( const fml::closure &  callback)
inline

Definition at line 281 of file flutter_windows_engine.h.

281  {
282  root_isolate_create_callback_ = callback;
283  }

References callback.

◆ SetSwitches()

void flutter::FlutterWindowsEngine::SetSwitches ( const std::vector< std::string > &  switches)

Definition at line 263 of file flutter_windows_engine.cc.

264  {
265  project_->SetSwitches(switches);
266 }

References SetSwitches().

Referenced by SetSwitches().

◆ Stop()

bool flutter::FlutterWindowsEngine::Stop ( )
virtual

Definition at line 512 of file flutter_windows_engine.cc.

512  {
513  if (engine_) {
514  window_manager_->OnEngineShutdown();
515  for (const auto& [callback, registrar] :
516  plugin_registrar_destruction_callbacks_) {
517  callback(registrar);
518  }
519  FlutterEngineResult result = embedder_api_.Shutdown(engine_);
520  engine_ = nullptr;
521  return (result == kSuccess);
522  }
523  return false;
524 }

Referenced by FlutterDesktopEngineDestroy().

◆ task_runner()

◆ text_input_plugin()

TextInputPlugin* flutter::FlutterWindowsEngine::text_input_plugin ( )
inline

Definition at line 206 of file flutter_windows_engine.h.

206 { return text_input_plugin_.get(); }

◆ texture_registrar()

FlutterWindowsTextureRegistrar* flutter::FlutterWindowsEngine::texture_registrar ( )
inline

Definition at line 177 of file flutter_windows_engine.h.

177  {
178  return texture_registrar_.get();
179  }

Referenced by FlutterDesktopRegistrarGetTextureRegistrar().

◆ UnregisterExternalTexture()

bool flutter::FlutterWindowsEngine::UnregisterExternalTexture ( int64_t  texture_id)

Definition at line 943 of file flutter_windows_engine.cc.

943  {
944  return (embedder_api_.UnregisterExternalTexture(engine_, texture_id) ==
945  kSuccess);
946 }

◆ UpdateAccessibilityFeatures()

void flutter::FlutterWindowsEngine::UpdateAccessibilityFeatures ( )

◆ UpdateDisplay()

void flutter::FlutterWindowsEngine::UpdateDisplay ( const std::vector< FlutterEngineDisplay > &  displays)

Definition at line 714 of file flutter_windows_engine.cc.

715  {
716  if (engine_) {
717  embedder_api_.NotifyDisplayUpdate(engine_,
718  kFlutterEngineDisplaysUpdateTypeStartup,
719  displays.data(), displays.size());
720  }
721 }
std::vector< FlutterEngineDisplay > * displays

Referenced by flutter::DisplayManagerWin32::UpdateDisplays().

◆ UpdateFlutterCursor()

void flutter::FlutterWindowsEngine::UpdateFlutterCursor ( const std::string &  cursor_name) const

Definition at line 1086 of file flutter_windows_engine.cc.

1087  {
1088  SetFlutterCursor(GetCursorByName(cursor_name));
1089 }
void SetFlutterCursor(HCURSOR cursor) const

◆ UpdateHighContrastMode()

void flutter::FlutterWindowsEngine::UpdateHighContrastMode ( )

Definition at line 1025 of file flutter_windows_engine.cc.

1025  {
1026  high_contrast_enabled_ = windows_proc_table_->GetHighContrastEnabled();
1027 
1028  SendAccessibilityFeatures();
1029  settings_plugin_->UpdateHighContrastMode(high_contrast_enabled_);
1030 }

Referenced by flutter::FlutterWindowsView::OnHighContrastChanged().

◆ UpdateSemanticsEnabled()

void flutter::FlutterWindowsEngine::UpdateSemanticsEnabled ( bool  enabled)

Definition at line 990 of file flutter_windows_engine.cc.

990  {
991  if (engine_ && semantics_enabled_ != enabled) {
992  std::shared_lock read_lock(views_mutex_);
993 
994  semantics_enabled_ = enabled;
995  embedder_api_.UpdateSemanticsEnabled(engine_, enabled);
996  for (auto iterator = views_.begin(); iterator != views_.end(); iterator++) {
997  iterator->second->UpdateSemanticsEnabled(enabled);
998  }
999  }
1000 }

Referenced by flutter::FlutterWindowsView::OnUpdateSemanticsEnabled(), and flutter::testing::TEST_F().

◆ view()

FlutterWindowsView * flutter::FlutterWindowsEngine::view ( FlutterViewId  view_id) const

Definition at line 692 of file flutter_windows_engine.cc.

692  {
693  std::shared_lock read_lock(views_mutex_);
694 
695  auto iterator = views_.find(view_id);
696  if (iterator == views_.end()) {
697  return nullptr;
698  }
699 
700  return iterator->second;
701 }

Referenced by flutter::AccessibilityPlugin::Announce(), FlutterDesktopPluginRegistrarGetView(), FlutterDesktopPluginRegistrarGetViewById(), InternalFlutterWindows_WindowManager_GetTopLevelWindowHandle(), and Run().

◆ window_manager()

◆ window_proc_delegate_manager()

WindowProcDelegateManager* flutter::FlutterWindowsEngine::window_proc_delegate_manager ( )
inline

◆ windows_proc_table()

std::shared_ptr<WindowsProcTable> flutter::FlutterWindowsEngine::windows_proc_table ( )
inline

Friends And Related Function Documentation

◆ EngineModifier

friend class EngineModifier
friend

Definition at line 368 of file flutter_windows_engine.h.


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