[Qt] Add OptionContainer widget

changes/3914.feature.7.md

@@ -0,0 +1 @@
+The OptionContainer widget is now supported in the Qt backend.

docs/en/reference/data/apis_by_platform.yaml

@@ -222,7 +222,6 @@ Layout widgets:
     unsupported:
       - web
       - textual
-      - qt
 
 Resources:
   path: resources

qt/src/toga_qt/factory.py

@@ -19,6 +19,7 @@
     from .widgets.label import Label
     from .widgets.multilinetextinput import MultilineTextInput
     from .widgets.numberinput import NumberInput
+    from .widgets.optioncontainer import OptionContainer
     from .widgets.passwordinput import PasswordInput
     from .widgets.progressbar import ProgressBar
     from .widgets.switch import Switch
@@ -54,6 +55,7 @@
     "Label",
     "MultilineTextInput",
     "NumberInput",
+    "OptionContainer",
     "PasswordInput",
     "ProgressBar",
     "Switch",

qt/src/toga_qt/icons.py

@@ -42,6 +42,6 @@ def __init__(self, interface, path):
         if self.native.isNull():
             raise ValueError(f"Unable to load icon from {path}")
 
-        IMPL_DICT[self.native] = self
+        IMPL_DICT[self.native.cacheKey()] = self
 
         self.path = path

qt/src/toga_qt/widgets/optioncontainer.py

@@ -0,0 +1,94 @@
+from PySide6.QtGui import QIcon
+from PySide6.QtWidgets import QTabWidget
+from travertino.size import at_least
+
+from ..container import Container
+from ..icons import IMPL_DICT
+from .base import Widget
+
+
+class OptionContainer(Widget):
+    uses_icons = True
+
+    def create(self):
+        self.native = QTabWidget()
+        self.native.currentChanged.connect(self.qt_current_changed)
+
+        self.sub_containers = []
+
+    def qt_current_changed(self, *args):
+        self.interface.on_select()
+
+    def add_option(self, index, text, widget, icon=None):
+        sub_container = Container(on_refresh=self.content_refreshed)
+        sub_container.content = widget
+
+        self.sub_containers.insert(index, sub_container)
+        if icon is None:
+            self.native.insertTab(index, sub_container.native, text)
+        else:
+            self.native.insertTab(index, sub_container.native, icon._impl.native, text)
+
+    def remove_option(self, index):
+        self.native.removeTab(index)
+        self.sub_containers[index].content = None
+        del self.sub_containers[index]
+
+    def set_option_enabled(self, index, enabled):
+        self.native.setTabEnabled(index, enabled)
+
+    def is_option_enabled(self, index):
+        return self.native.isTabEnabled(index)
+
+    def set_option_text(self, index, value):
+        self.native.setTabText(index, value)
+
+    def get_option_text(self, index):
+        return self.native.tabText(index)
+
+    def set_option_icon(self, index, value):
+        if value is None:
+            self.native.setTabIcon(index, QIcon())
+        else:
+            self.native.setTabIcon(index, value._impl.native)
+
+    def get_option_icon(self, index):
+        impl = IMPL_DICT.get(self.native.tabIcon(index).cacheKey(), None)
+        if impl is None:
+            return None
+        else:
+            return impl.interface
+
+    def get_current_tab_index(self):
+        return self.native.currentIndex()
+
+    def set_current_tab_index(self, current_tab_index):
+        return self.native.setCurrentIndex(current_tab_index)
+
+    def rehint(self):
+        size = self.native.sizeHint()
+        self.interface.intrinsic.width = at_least(
+            max(size.width(), self.interface._MIN_WIDTH)
+        )
+        self.interface.intrinsic.height = at_least(
+            max(size.height(), self.interface._MIN_HEIGHT)
+        )
+
+    def set_bounds(self, x, y, width, height):
+        super().set_bounds(x, y, width, height)
+        for item in self.interface.content:
+            item.content.refresh()
+
+    def content_refreshed(self, container):
+        min_width = min(
+            sub_container.content.interface.layout.min_width
+            for sub_container in self.sub_containers
+        )
+        min_height = min(
+            sub_container.content.interface.layout.min_height
+            for sub_container in self.sub_containers
+        )
+        for sub_container in self.sub_containers:
+            sub_container.native.setMinimumSize(min_width, min_height)
+            sub_container.min_width = min_width
+            sub_container.min_height = min_height

qt/tests_backend/widgets/optioncontainer.py

@@ -0,0 +1,27 @@
+from PySide6.QtWidgets import QTabWidget
+
+from .base import SimpleProbe
+
+
+class OptionContainerProbe(SimpleProbe):
+    native_class = QTabWidget
+    max_tabs = None
+    disabled_tab_selectable = True
+
+    def select_tab(self, index):
+        self.native.setCurrentIndex(index)
+
+    def tab_enabled(self, index):
+        return self.native.isTabEnabled(index)
+
+    async def wait_for_tab(self, message):
+        return
+
+    def assert_tab_icon(self, index, expected):
+        actual = self.impl.get_option_icon(index)
+        if expected is None:
+            assert actual is None
+        else:
+            assert actual is not None
+            assert actual.path.name == expected
+            assert actual._impl.path.name == f"{expected}-linux.png"