New Desktop API 2.0 Controls <-- Read This

Xojo 2021 Release 3 introduces many new features and improvements. Among these are the new Desktop controls, which are the final part of our multi-year update to API 2.0. These controls bring Desktop projects up to API 2.0 with new naming, event names that are consistent with other platforms, and more.

You do not need to update your existing projects to these controls today, nor do you need to use these new controls to use R3. We worked really hard to make sure the API 1.0 and API 2.0 controls can coexist. You do not need to update your entire app, you can update a single control, mix and match, etc. You can continue to use API 1.0 for the foreseeable future, your existing code will continue to function. If you want to update, you can do it at your own pace and we tried to make that as easy as possible.

Important Points:

  1. You can continue to use the existing API 1.0 controls and still use Xojo 2021 Release 3.
  2. You can mix and match old and new controls on layouts.
  3. You can migrate your existing controls.
  4. You do not have to do any of this today.

Note: Once a project has any new project items in it, it is incompatible with older versions of Xojo. Starting new projects with 2021r3 defaults to the new API 2.0 desktop controls.

Documentation Links about Moving to API 2.0: