Upgrading the SDK

Version 8.1.0

The following service was added:

• uie::splitter_window_v3

The following functions were added:

• uie::utils::remap_category()

• uie::utils::get_remapped_category()

• cui::config_objects::get_use_smooth_scrolling()

The following named constant was added:

• cui::config_objects::guid_bool_use_smooth_scrolling

Version 8.0.0

cui::fonts::manager_v3 and related services are no longer marked experimental.

Version 8.0.0-rc.1

New in this version

The following services were updated:

• cui::fonts::manager_v3

• cui::fonts::rendering_options

• cui::fonts::font

The following functions were updated:

• cui::dwrite_utils::create_custom_rendering_params()

Version 8.0.0-beta.1

Highlights

This version adds a new, experimental cui::fonts::manager_v3 service with DirectWrite support.

New in this version

The following services were added:

• cui::fonts::manager_v3

• cui::fonts::rendering_options

• cui::fonts::font

The following enumerations were added:

• cui::fonts::font_family_model

The following exceptions were added:

• cui::fonts::exception_font_client_not_found

The following named constants were added:

• cui::fonts::items_font_id

• cui::fonts::labels_font_id

• cui::fonts::core_console_font_id

• cui::fonts::core_default_font_id

• cui::fonts::core_lists_font_id

The following helpers were added:

• cui::fonts::get_log_font()

• cui::fonts::get_log_font_with_fallback()

• cui::fonts::create_hfont_with_fallback()

• cui::fonts::get_font()

• cui::fonts::on_common_font_changed()

• cui::dwrite_utils::get_monitor_for_window()

• cui::dwrite_utils::create_custom_rendering_params()

Bug fixes

• The project file was updated to remove ..\columns_ui-sdk from referenced file paths. This makes it possible for names other than columns_ui-sdk to be used for the directory containing the Columns UI SDK.

• cui::colours::client::factory and cui::fonts::client::factory are now defined to be service_factory_single_t rather than service_factory_t.

Deprecated in this version

The following functions were deprecated:

• uStatus_SetText()

• win32_helpers::message_box()

Removed in this version

The following deprecated named constants were removed:

• cui::panels::guid_playlist_view

The following enumerations were removed:

• cui::fonts::font_mode_t

The following structs were removed:

• uTOOLINFO

• uHDITEM

The following preprocessor macros were removed:

• RECT_CX()

• RECT_CY()

The following deprecated classes were removed:

• uie::container_menu_ui_extension

• uie::container_window_autorelease_t

• uie::container_window_release_t

The following deprecated functions were removed:

• uHeader_InsertItem()

• uHeader_SetItemText()

• uHeader_SetItemWidth()

• uToolTip_AddTool()

• uComboBox_SelectString()

• win32_helpers::send_message_to_all_children()

• win32_helpers::tooltip_add_tool()

Version 7.0.0

New in this version

This version fixes a compilation error when the <version> header had not been included, and it also fixes a crash in container_uie_window_v3_t::destroy_window() if it’s called when the window has already been destroyed, or was never created.

Version 7.0.0-beta.2

New in this version

This version adds an option to uie::container_window_v3 to disable the forwarding of WM_SETTINGCHANGE messages to direct child windows.

This is useful when hosting the Win32 toolbar control as it can misbehave when handling this message.

Version 7.0.0-beta.1

This version of the Columns UI SDK requires Visual Studio 2022.

The project file was also renamed columns_ui-sdk-public.vcxproj.

New in this version

This version adds:

• support for the Columns UI dark mode

• preliminary support for compiling x64 panels

• uie::container_uie_window_v3_t

• uie::container_window_v3

• uie::simple_command_menu_node

• uie::splitter_item_full_v2_t

• uie::splitter_item_full_v3_t

• uie::splitter_item_full_v3_impl_t

• uie::splitter_window::size_and_dpi

• cui::fcl::dataset_v2

• cui::fonts::manager_v2

• cui::config_objects::get_locked_panel_resizing_allowed()

• uie::win32::paint_background_using_parent()

Renamed namespaces

• The ui_extension namespace was renamed uie

• The columns_ui namespace was renamed cui

Aliases exist for the old names for backwards compatibility.

Deprecated in this version

The following classes were deprecated:

• uie::container_ui_extension_t

• uie::container_ui_extension

• uie::container_menu_ui_extension

• uie::container_uie_window_t

• uie::container_window_autorelease_t

• uie::container_window_release_t

• uie::container_window

The following functions were deprecated:

• uHeader_InsertItem()

• uHeader_SetItemText()

• uHeader_SetItemWidth()

• uToolTip_AddTool()

• uComboBox_SelectString()

• win32_helpers::send_message_to_all_children()

• win32_helpers::tooltip_add_tool()

Removed in this version

Example components are no longer bundled with the SDK. These are now published on GitHub:

• Example panel

• Console panel

The following classes were removed:

• uie::window_base_t

• logfont_os_menu

• logfont_os_icon

• logfont_os_from_utf8

• logfont_utf8_from_os

The following functions were removed:

• uGetClassLong()

• uSetClassLong()

• convert_logfont_utf8_to_os()

• convert_logfont_os_to_utf8()

The following macros were removed:

• uT()

• uTS()

• Tu()

• TSu()