SearchField QML Type

该属性保存清除指示符。

该属性保存弹出列表中当前所选建议的索引。

当计数为0 时，默认值为-1 ，否则为0 。

另请参阅 activated(),text, 和highlightedIndex 。

该属性包含一个在搜索栏弹出窗口中显示项目的委托。

建议使用ItemDelegate （或任何其他AbstractButton 衍生工具）作为委托。这样可以确保交互按预期进行，并在适当的时候自动关闭弹出窗口。如果使用其他类型作为委托，则必须手动关闭弹出窗口。例如，如果使用MouseArea ：

delegate: Rectangle {
    // ...
    MouseArea {
        // ...
        onClicked: searchField.popup.close()
    }
}

该属性包含为搜索字段提供委托实例的模型。

它通常分配给popup 的contentItem 中的ListView 。

该属性保存弹出列表中当前高亮显示项的索引。

高亮显示的项目被激活后，弹出窗口关闭，currentIndex 更新为与highlightedIndex 匹配，该属性重置为-1 ，表示当前没有高亮显示的项目。

另请参阅 highlighted() 和currentIndex 。

该属性包含一个布尔值，用于决定是否在每次文本编辑时触发搜索。

当设置为true 时，每次文本更改都会发出searchTriggered() 信号，从而可以对每次按键做出响应。当设置为false 时，只有当用户按下 Enter 或 Return 键时，才会发出searchTriggered() 信号。

另请参阅 searchTriggered()。

该属性用于保存弹出窗口。

如有必要，可手动打开或关闭弹出窗口：

onSpecialEvent: searchField.popup.close()

该属性显示搜索指示符。

该属性用于保存要从建议模型中显示的建议数量。

该属性包含用于在弹出菜单中显示搜索建议的数据模型。

SearchField {
    textRole: "age"
    suggestionModel: ListModel {
        ListElement { name: "Karen"; age: "66" }
        ListElement { name: "Jim"; age: "32" }
        ListElement { name: "Pamela"; age: "28" }
    }
}

另请参阅 textRole 。

该属性用于保存搜索字段中的当前输入文本。

文本与用户输入绑定，触发建议更新或搜索逻辑。

另请参阅 searchTriggered() 和textEdited()。

此属性保存用于在弹出列表中显示建议模型中项目的模型角色。

当模型有多个角色时，可设置textRole 以确定应显示哪个角色。

当用户按 Enter 或 Return 键确认输入时，将发出该信号。

该信号通常用于根据最终输入的文本触发搜索或操作，并表明用户打算完成或提交查询。

另请参阅 searchTriggered() 。

当index 上的项目被用户激活时，将发出该信号。

当一个项目在弹出窗口打开时被选中并导致弹出窗口关闭（以及currentIndex 变更）时，该项目即被激活。currentIndex 属性被设置为index 。

另请参阅 currentIndex 。

当用户高亮显示弹出列表中index 处的项目时，将发出该信号。

高亮信号仅在弹出窗口打开且项目被高亮时发出，但不一定是activated 。

另请参阅 highlightedIndex 。

该信号在搜索操作启动时发出。

有两种情况1.按下 Enter 或 Return 键时，它将与accepted() 信号一起发出 2.编辑文本时，如果live 属性设置为true ，则会发出该信号。

根据所需的交互模式，该信号非常适合在用户键入时按需或实时启动搜索。

另请参阅 accepted() 和textEdited()。

每次用户修改搜索字段中的文本（通常是每次按键）时，都会发出该信号。

另请参阅 searchTriggered() 。