变量选择器类

class Utils::VariableChooser

VariableChooser 类用于向行编辑、文本编辑或纯文本编辑中添加用于选择 Qt Creator 变量的工具窗口。更多...

头文件	#include <coreplugin/variablechooser.h>
继承	QWidget

包括继承成员在内的所有成员列表

公共函数

	VariableChooser(QWidget *parent = nullptr)
void	addMacroExpanderProvider(const Utils::MacroExpanderProvider &provider)
void	addSupportedWidget(QWidget *textcontrol, const QByteArray &ownName = QByteArray())

详细描述

如果您允许用户将其 UI 中指定的字符串添加到 Qt Creator 变量，例如当用户可以通过文本控件提供字符串时，您应该在其中添加变量选择器。变量选择器允许用户打开一个包含所有可用变量及其描述的工具窗口。双击变量会将相应字符串插入到相应的文本控件中，如行编辑。

"External Tools Preferences with Variable Chooser"

变量选择器会监视父窗口所有子项的焦点变化。当文本控件获得焦点时，变量选择器检查它是否已设置变量支持。如果控件支持变量，当它获得焦点时，会显示打开变量选择器的工具按钮。

支持文本控件包括 QLineEdit、QTextEdit 和 QPlainTextEdit。

当其父内容窗口被删除时，变量选择器也会被删除。

示例

QWidget *myOptionsContainerWidget = new QWidget;
new Utils::VariableChooser(myOptionsContainerWidget)
QLineEdit *myLineEditOption = new QLineEdit(myOptionsContainerWidget);
myOptionsContainerWidget->layout()->addWidget(myLineEditOption);
Utils::VariableChooser::addVariableSupport(myLineEditOption);

成员函数文档

`[显式]` VariableChooser::VariableChooser(QWidget **parent* = nullptr)

创建一个变量选择器，用于跟踪 parent 的所有子项以检测变量支持。所有权也转移给 parent。

void VariableChooser::addMacroExpanderProvider(const Utils::MacroExpanderProvider &provider)

添加宏展开提供程序 provider。

void VariableChooser::addSupportedWidget(QWidget **textcontrol, const QByteArray &ownName* = QByteArray())

将控件 textcontrol 标记为支持变量。

如果控件直接向宏展开器提供变量，则设置 ownName 为变量名，以防止用户选择变量，这可能导致无限递归。