Qt QML Quick Controls 2 ComboBox弹窗自定义为何引用delegateModel而非model？及delegateModel属性文档位置咨询

Great question! Let's break this down clearly, since this is a common point of confusion when customizing Qt Quick Controls 2 components.

为什么用control.delegateModel而非直接用control.model？ #

Here's the core reason: Qt Quick Controls 2's ComboBox internally creates and manages a DelegateModel instance via its delegateModel property, and this instance is pre-configured to work seamlessly with the ComboBox's state.

If you used control.model directly in your custom ListView, you'd miss out on critical built-in functionality that delegateModel handles automatically:

• Selected item synchronization: It automatically binds the ComboBox's currentIndex to the list's selected item, handling the highlight state of the active choice without you writing extra code.
• Delegate reuse: It already links to the ComboBox's configured delegate, so you don't have to redefine or rebind the delegate in your custom ListView.
• Filter support: If you've enabled the ComboBox's filterMode, delegateModel automatically applies the filter logic to the underlying model—something you'd have to implement manually if you used the raw model.
• State consistency: It ensures the popup's list stays in sync with the ComboBox's internal state (like enabled/disabled items) without extra boilerplate.

In the example code, the conditional model: control.popup.visible ? control.delegateModel : null is a minor optimization to clean up resources when the popup is hidden, but the real value comes from using the pre-wired delegateModel.

哪里能找到delegateModel属性的文档？ #

You can find details in two key places within Qt's official documentation:

1. ComboBox类的属性列表: The delegateModel property is explicitly documented under the ComboBox class's properties section. This entry explains how the ComboBox uses it, and notes its type as DelegateModel from the Qt Quick module.
2. DelegateModel类文档: For a deep dive into the underlying mechanics (like filtering, sorting, and delegate management), you can look up the standalone DelegateModel class documentation in the Qt Quick core module.

Since this property is tailored to the ComboBox's internal setup, starting with the ComboBox's documentation will give you the most relevant context for customizing popups like the example shows.

内容的提问来源于stack exchange，提问作者DavidJ