VariableChooser Classclass Utils::VariableChooser
The VariableChooser class is used to add a tool window for selecting Qt Creator variables to line edits, text edits or plain text edits. More...
|VariableChooser(QWidget *parent = nullptr)|
|void||addSupportedWidget(QWidget *textcontrol, const QByteArray &ownName = QByteArray())|
If you allow users to add Qt Creator variables to strings that are specified in your UI, for example when users can provide a string through a text control, you should add a variable chooser to it. The variable chooser allows users to open a tool window that contains the list of all available variables together with a description. Double-clicking a variable inserts the corresponding string into the corresponding text control like a line edit.
The variable chooser monitors focus changes of all children of its parent widget. When a text control gets focus, the variable chooser checks if it has variable support set. If the control supports variables, a tool button which opens the variable chooser is shown in it while it has focus.
Supported text controls are QLineEdit, QTextEdit and QPlainTextEdit.
The variable chooser is deleted when its parent widget is deleted.
Member Function Documentation
VariableChooser::VariableChooser(QWidget *parent = nullptr)
Creates a variable chooser that tracks all children of parent for variable support. Ownership is also transferred to parent.
void VariableChooser::addSupportedWidget(QWidget *textcontrol, const QByteArray &ownName = QByteArray())
Marks the control textcontrol as supporting variables.
If the control provides a variable to the macro expander itself, set ownName to the variable name to prevent the user from choosing the variable, which would lead to endless recursion.
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.