kgendesignerplugin - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

kgendesignerplugin - генерує плагіни віджетів для Qt(TM) Designer.

СИНТАКСИС

kgendesignerplugin [ВАРІАНТИ...] файл

ОПИС

Спеціальні плагіни віджетів для Qt(TM) Designer зазвичай дотримуються стандартного шаблону
класи, надані плагіном, здебільшого надають статичну інформацію, а також функції для
створити екземпляр, який зазвичай є простим викликом конструктора. kgendesignerplugin
дозволяє розробникам бібліотек, які надають нові віджети, створювати такий плагін без
створення всього відповідного шаблонного коду, надавши простий опис у стилі ini
файлу.

kgendesignerplugin вибирає розумні значення за замовчуванням для більшості налаштувань, тому мінімальна конфігурація
зазвичай це необхідно.

ВАРІАНТИ

-o файл
Ім'я згенерованого файлу C++. Якщо не дано, stdout буде використовуватися.

-n ім'я плагіна
Передбачено сумісність. Значення за замовчуванням для параметра PluginName у вводі
файлу.

-g група
Передбачено сумісність. Значення за замовчуванням для параметра DefaultGroup у вводі
файлу.

--автор
Показати інформацію про автора.

--ліцензія
Показати інформацію про ліцензію.

-h, --допомога
Покажіть короткий текст довідки.

-v , -- версія
Показати інформацію про версію.

Фото ФОРМАТ

Вхідний файл є файлом конфігурації в стилі ini (зокрема, він у форматі
підтримується платформою KConfig), що описує набір віджетів. Він містить а
Розділ [Global], що містить загальну інформацію про плагін, а також розділ для кожного
віджет, який слід включити в плагін.

Розділ [Global] може містити такі записи:

DefaultGroup
Значення за замовчуванням для Group запис у розділах класу (за замовчуванням: "Custom", якщо
-g надається варіант).

Включає в себе
Список необхідних (розділених комами) включає (за замовчуванням: порожній). Зверніть увагу, що заголовок
файли для віджетів, зазначених пізніше у файлі, не слід перераховувати тут; замість цього це
призначений для спеціальних заголовків для власного використання плагіна, як-от заголовків для класів
попередні перегляди.

Назва плагіна
Назва основного класу C++ у плагіні (за замовчуванням: "WidgetsPlugin", якщо -n
надається варіант).

Кожен клас повинен мати свій [ClassName], який може включати наступне
записи:

Шаблон коду
Значення, що повертається функцією codeTemplate() плагіна, який позначено як
"використання в майбутньому" від Qt(TM) Designer (за замовчуванням: порожній).

ConstructorArgs
Аргументи для передачі конструктору класу, заданому ImplClass; ці повинні
бути оточений дужками (за замовчуванням: "(батьків)"). Єдина змінна, яка гарантовано буде
доступний є батько, який є батьківським QWidget, переданим Qt(TM) Designer.

Цей запис ігнорується, якщо встановлено CreateWidget.

Створити віджет
Код, необхідний для створення екземпляра віджета (за замовчуванням: для створення файлу використовується new
екземпляр класу, заданий записом ImplClass, передаючи аргументи, зазначені в
ConstructorArgs). Дивіться примітки щодо ImplClass і ConstructorArgs.

DomXML
Опис інтерфейсу XML віджету (за замовчуванням: за замовчуванням надається Qt(TM)
Дизайнерські заголовки плагінів).

Group
Група для відображення віджета в Qt(TM) Designer (за замовчуванням: значення
DefaultGroup запис у розділі [Global]).

IconName
Файл зображення або стандартна назва піктограми для використання як піктограми для цього віджета в Qt(TM)
Список віджетів конструктора (за замовчуванням: файл PNG з назвою розділу з будь-яким подвійним
двокрапки видалені в каталозі "pics" скомпільованого файлу ресурсу; наприклад,
:/pics/Foo.png у розділі [Foo] або :/pics/FooBar.png у розділі [Foo::Bar]).

ImplClass
Клас, який слід використовувати для створення екземпляра віджета для використання
Qt(TM) Designer (за замовчуванням: назва розділу). Зауважте, що це насправді не обов’язково
бути класом, який буде створений для кінцевої програми: це визначається за допомогою
DomXML.

Цей запис ігнорується, якщо встановлено CreateWidget.

IncludeFile
Заголовок, який потрібно включити, щоб використовувати цей віджет (за замовчуванням: нижній регістр
версія назви розділу з вилученими двокрапками та доданими «.h»; наприклад,
foo.h у розділі [Foo] або foobar.h у розділі [Foo::Bar]).

IsContainer
Чи може цей віджет містити інші віджети (за замовчуванням: false).

Підказка
Підказка для відображення при наведенні курсора на віджет у списку віджетів Qt(TM)
Конструктор (за замовчуванням: назва розділу з додаванням «Віджет»; наприклад, Foo Widget
у розділі [Foo]).

Що це
Текст "Що це", пов'язаний з віджетом у Qt(TM) Designer (за замовчуванням: the
назва розділу з додаванням «Віджет»; наприклад, Foo Widget в розділі [Foo]).

ПРИКЛАДИ

Найпростіший файл опису може виглядати так

[Фу]
ToolTip=Відображає foos
[бар]
ToolTip=Редактор панелі

Зверніть увагу, що кожен клас повинен мати принаймні один набір ключів (у цьому прикладі використовувалася підказка),
інакше це буде проігноровано.

Зазвичай потрібно змінити принаймні видимий користувачеві текст, тобто підказку,
WhatsThis та записи в групах. Крім того, гарною ідеєю може бути встановлення назви плагіна
запобігати можливим зіткненням символів і не плутати налагоджувачі (як програми налагодження
та особа, яка виконує налагодження):

[Глобально]
PluginName=FooWidgets
DefaultGroup=Показати

[Фу]
ToolTip=Показує ведмедів
WhatsThis=Віджет зображення, який відображає танцюючих ведмедів

[бар]
ToolTip=Редактор панелі
WhatsThis=Інтерфейс редактора барів для ведмедів
Група=Редагування

Більш складні файли можуть знадобитися, якщо у вас є класи з простором імен або додаткові параметри
потребують надання конструкторам, наприклад:

[Глобально]
PluginName=FooWidgets
DefaultGroup=Foo

[Foo::Bar]
ToolTip=Відображає смуги
WhatsThis=Віджет, який показує смуги певним чином
IncludeFile=foo/bar.h
IconName=:/previews/bar.png

[Foo::Baz]
IncludeFile=foo/baz.h
ConstructorArgs=(Foo::Baz::SomeOption, батьківський)
Group=Foo (Спеціальний)
IsContainer=true
IconName=:/previews/baz.png

Іноді для особливо складних віджетів може знадобитися спеціальна реалізація класу попереднього перегляду
для використання в Qt(TM) Designer; це може бути підклас справжнього віджета, який просто робить
деякі додаткові налаштування, або це може бути зовсім інша реалізація.

[Глобально]
Включає=foopreviews.h

[FancyWidget]
ImplClass=FancyWidgetPreview

Використовуйте kgendesignerplugin онлайн за допомогою служб onworks.net