kgendesignerplugin – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

kgendesignerplugin – Erzeugt Widget-Plugins für Qt(TM) Designer.

ZUSAMMENFASSUNG

kgendesignerplugin [OPTIONAL...] Datei

BESCHREIBUNG

Die benutzerdefinierten Widget-Plugins für Qt(TM) Designer folgen normalerweise einem Standardmuster
Die vom Plugin bereitgestellten Klassen stellen meist statische Informationen sowie Funktionen bereit
Erstellen Sie eine Instanz, die normalerweise nur ein einfacher Konstruktoraufruf ist. kgendesignerplugin
ermöglicht es Entwicklern von Bibliotheken, die neue Widgets bereitstellen, ein solches Plugin ohne zu erstellen
Erstellen des gesamten zugehörigen Boilerplate-Codes durch Bereitstellung einer einfachen Beschreibung im INI-Stil
Datei.

kgendesignerplugin wählt für die meisten Einstellungen sinnvolle Standardeinstellungen, also minimale Konfiguration
ist in der Regel notwendig.

OPTIONAL

-o Datei
Der Name für die generierte C++-Datei. Falls nicht angegeben, stdout werden verwendet.

-n Plugin-Name
Aus Kompatibilitätsgründen bereitgestellt. Der Standardwert für die Option PluginName in der Eingabe
Datei.

-g Gruppe
Aus Kompatibilitätsgründen bereitgestellt. Der Standardwert für die Option DefaultGroup in der Eingabe
Datei.

--Autor
Autoreninformationen anzeigen.

--Lizenz
Lizenzinformationen anzeigen.

-H, --help
Zeigt einen kurzen Hilfetext an.

-v , --Version
Versionsinformationen anzeigen.

FILE FORMAT

Die Eingabedatei ist eine Konfigurationsdatei im INI-Stil (insbesondere im Format
unterstützt vom KConfig-Framework), das eine Reihe von Widgets beschreibt. Es enthält eine
Abschnitt [Global] mit allgemeinen Informationen zum Plugin und jeweils einem Abschnitt
Widget, das im Plugin enthalten sein soll.

Der Abschnitt [Global] kann die folgenden Einträge enthalten:

Standardgruppe
Der Standardwert für Gruppe an Eintrag in den Klassenabschnitten (Standard: „Benutzerdefiniert“, sofern nicht
-g Option ist gegeben).

Enthält
Eine (durch Kommas getrennte) Liste erforderlicher Includes (Standard: leer). Beachten Sie, dass der Header
Dateien für die später in der Datei angegebenen Widgets sollten hier nicht aufgeführt werden. stattdessen dies
ist für spezielle Header für den eigenen Gebrauch des Plugins gedacht, beispielsweise für die Bereitstellung von Klassen
Vorschauen.

PluginName
Der Name der Haupt-C++-Klasse im Plugin (Standard: „WidgetsPlugin“, sofern nicht -n
Option ist gegeben).

Jede Klasse sollte ihre eigene [Klassenname] Abschnitt, der Folgendes enthalten kann
Einträge:

CodeTemplate
Der von der codeTemplate()-Funktion des Plugins zurückgegebene Wert, der für markiert ist
„zukünftige Verwendung“ von Qt(TM) Designer (Standard: leer).

KonstruktorArgs
Die Argumente, die an den Konstruktor der durch ImplClass angegebenen Klasse übergeben werden sollen; diese müssen
in Klammern eingeschlossen sein (Standard: „(parent)“). Die einzige Variable, die es garantiert gibt
verfügbar ist Elternteil, das übergeordnete QWidget, das von Qt(TM) Designer übergeben wird.

Dieser Eintrag wird ignoriert, wenn CreateWidget gesetzt ist.

CreateWidget
Der zum Erstellen einer Instanz des Widgets erforderliche Code (Standard: verwendet new zum Erstellen eines
Instanz der durch den ImplClass-Eintrag angegebenen Klasse und übergibt die durch angegebenen Argumente
KonstruktorArgs). Siehe die Hinweise zu ImplClass und ConstructorArgs.

DomXML
Eine XML-UI-Beschreibung des Widgets (Standard: der von Qt(TM) bereitgestellte Standard)
Designer-Plugin-Header).

Gruppe an
Die Gruppe, unter der das Widget in Qt(TM) Designer angezeigt werden soll (Standard: der Wert von
Standardgruppe Eintrag im Abschnitt [Global]).

Symbolname
Der Bilddatei- oder Standardsymbolname, der als Symbol für dieses Widget in Qt(TM) verwendet werden soll.
Designer-Widget-Liste (Standard: eine PNG-Datei mit dem Namen des Abschnitts, mit einem beliebigen Doppelnamen
Doppelpunkte entfernt, im Verzeichnis „pics“ einer kompilierten Ressourcendatei; Zum Beispiel,
:/pics/Foo.png im Abschnitt [Foo] oder :/pics/FooBar.png im Abschnitt [Foo::Bar]).

ImplClass
Die Klasse, die zum Erstellen einer Instanz des Widgets zur Verwendung verwendet werden soll
Qt(TM) Designer (Standard: der Abschnittsname). Beachten Sie, dass dies nicht unbedingt erforderlich ist
sei die Klasse, die für eine Endanwendung erstellt würde: Das wird durch die bestimmt
DomXML.

Dieser Eintrag wird ignoriert, wenn CreateWidget gesetzt ist.

IncludeFile
Der Header, der eingefügt werden muss, um dieses Widget zu verwenden (Standard: der Kleinbuchstabe).
Version des Abschnittsnamens, wobei alle Doppelpunkte entfernt und „.h“ angehängt wurden; Zum Beispiel,
foo.h im Abschnitt [Foo] oder foobar.h im Abschnitt [Foo::Bar]).

IstContainer
Ob dieses Widget andere Widgets enthalten kann (Standard: false).

ToolTip
Der Tooltip, der angezeigt wird, wenn Sie mit der Maus über das Widget in der Widget-Liste von Qt(TM) fahren.
Designer (Standard: der Abschnittsname mit angehängtem „Widget“, zum Beispiel Foo Widget
im Abschnitt [Foo]).

Was ist das
Der „Was ist das“-Text, der mit dem Widget in Qt(TM) Designer verknüpft ist (Standard: der
Abschnittsname mit angehängtem „Widget“; zum Beispiel Foo Widget im Abschnitt [Foo]).

Beispiele:

Die einfachste Beschreibungsdatei könnte so aussehen

[Foo]
ToolTip=Zeigt Foos an
[Bar]
ToolTip=Balkeneditor

Beachten Sie, dass jede Klasse mindestens einen Schlüsselsatz haben muss (in diesem Beispiel wurde ToolTip verwendet).
andernfalls wird es ignoriert.

Normalerweise möchten Sie zumindest den für den Benutzer sichtbaren Text ändern, also den ToolTip,
WhatsThis- und Gruppeneinträge. Darüber hinaus kann es sinnvoll sein, den Plugin-Namen festzulegen
Vermeiden Sie mögliche Symbolkonflikte und verwirren Sie die Debugger nicht (sowohl die Debugger-Anwendung).
und die Person, die das Debugging durchführt):

[Global]
PluginName=FooWidgets
DefaultGroup=Anzeige

[Foo]
ToolTip=Zeigt Bären an
WhatsThis=Ein Bild-Widget, das tanzende Bären anzeigt

[Bar]
ToolTip=Balkeneditor
WhatsThis=Eine Editoroberfläche für Barren für Bären
Gruppe=Bearbeiten

Komplexere Dateien können erforderlich sein, wenn Sie Namespace-Klassen oder zusätzliche Optionen dafür haben
müssen an Bauherren geliefert werden, zum Beispiel:

[Global]
PluginName=FooWidgets
DefaultGroup=Foo

[Foo::Bar]
ToolTip=Zeigt Balken an
WhatsThis=Ein Widget, das Balken auf eine bestimmte Weise anzeigt
IncludeFile=foo/bar.h
IconName=:/previews/bar.png

[Foo::Baz]
IncludeFile=foo/baz.h
ConstructorArgs=(Foo::Baz::SomeOption, parent)
Group=Foo (Spezial)
IsContainer=true
IconName=:/previews/baz.png

Manchmal benötigen besonders komplexe Widgets eine spezielle „Vorschauklassen“-Implementierung
zur Verwendung im Qt(TM) Designer; Dies könnte eine Unterklasse des echten Widgets sein, das genau das tut
etwas zusätzliches Setup, oder es könnte eine völlig andere Implementierung sein.

[Global]
Includes=foopreviews.h

[FancyWidget]
ImplClass=FancyWidgetPreview

Verwenden Sie kgendesignerplugin online über die Dienste von onworks.net