Использование пользовательских виджетов с Qt Designer

Qt Designer может отображать пользовательские виджеты с помощью механизма расширяемых плагинов, позволяя пользователю и сторонним разработчикам расширять набор проектируемых виджетов. В качестве альтернативы можно использовать существующие виджеты в качестве заглушек для классов виджетов, предоставляющих аналогичные API.

Обработка пользовательских виджетов

Хотя Qt Designer поддерживает все стандартные виджеты Qt, некоторые специализированные виджеты могут быть недоступны по стандартным причинам:

• Пользовательские виджеты могут быть недоступны в момент проектирования пользовательского интерфейса.
• Пользовательские виджеты могут быть платформозависимыми, и разработчики пользовательского интерфейса могут разрабатывать его на другой платформе, чем конечные пользователи.
• Исходный код пользовательского виджета недоступен, или разработчики пользовательского интерфейса не могут использовать виджет по нетехническим причинам.

В указанных ситуациях по-прежнему можно проектировать формы с целью использования пользовательских виджетов в приложении. Для этого можно воспользоваться функцией повышения виджетов в Qt Designer.

Во всех остальных случаях, когда исходный код пользовательских виджетов доступен, мы можем адаптировать пользовательский виджет для использования с Qt Designer.

Повышение виджетов

Если некоторые формы необходимо спроектировать, но определенные пользовательские виджеты недоступны разработчику, можно заменить их аналогичными виджетами для представления отсутствующих виджетов. Например, мы можем представлять экземпляры класса пользовательской кнопки, MyPushButton, экземплярами QPushButton и повышать их до MyPushButton для того, чтобы uic генерировал соответствующий код для этого отсутствующего класса.

При выборе виджета в качестве заглушки полезно сравнить API отсутствующего виджета с API стандартных виджетов Qt. Для специализированных виджетов, которые являются подклассами стандартных классов, очевидным выбором заглушки является базовый класс пользовательского виджета; например, QSlider можно использовать для специализированных подклассов QSlider.

Для специализированных виджетов, которые не имеют общего API со стандартными виджетами Qt, стоит рассмотреть возможность адаптации пользовательского виджета для использования в Qt Designer. Если это невозможно, то QWidget является очевидным выбором для заглушки виджета, так как это наименьший общий знаменатель для всех виджетов.

Чтобы добавить заглушку, выберите объект подходящего базового класса и выберите Повысить до... из контекстного меню формы. После ввода имени класса и заголовочного файла в нижней части диалогового окна выберите Добавить. Класс заглушки теперь появится вместе с базовым классом в верхнем списке. Нажмите кнопку Повысить, чтобы принять этот выбор.

Теперь, когда контекстное меню формы открывается над объектами базового класса, класс заглушки появится в подменю Повысить до, что позволит удобно повышать объекты до этого класса.

Повышенный виджет можно вернуть к базовому классу, выбрав Снизить до из контекстного меню формы.

Пользовательские виджеты

Пользовательские виджеты можно адаптировать для использования с Qt Designer, что предоставляет разработчикам пользовательского интерфейса возможность настраивать пользовательский интерфейс, используя фактические виджеты, которые будут использоваться в приложении, а не заглушки виджетов. Процесс создания плагина пользовательского виджета описан в главе Создание пользовательских виджетов для Qt Designer данного руководства.

Чтобы использовать созданный таким образом плагин, необходимо убедиться, что плагин находится в пути, по которому Qt Designer ищет плагины. Как правило, плагины, хранящиеся в $QTDIR/plugins/designer будут загружаться при запуске Qt Designer. Дополнительную информацию о построении и установке плагинов можно найти здесь. Вы также можете обратиться к документу Руководство по плагинам для получения информации о создании плагинов.