'\" t .\" Title: \fBkgendesignerplugin\fR .\" Author: Richard Johnson .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 2014-05-28 .\" Manual: KDE Frameworks: KDesignerPlugin .\" Source: KDE Frameworks Frameworks 5.0 .\" Language: German .\" .TH "\FBKGENDESIGNERPLUGI" "1" "2014\-05\-28" "KDE Frameworks Frameworks 5.0" "KDE Frameworks: KDesignerPlugi" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" kgendesignerplugin \- Generiert Bedienelement\-Module (Widgets) f\(:ur Qt(TM)\-Designer .SH "\(:UBERSICHT" .HP \w'\fBkgendesignerplugin\fR\ 'u \fBkgendesignerplugin\fR [\fIOptionen\fR...] \fIDatei\fR .SH "BESCHREIBUNG" .PP Die benutzerdefinierten Bedienelement\-Module f\(:ur Qt(TM)\-Designer folgen normalerweise einem Standardmuster, und die vom Modul bereitgestellten Klassen bieten meist statische Informationen, zusammen mit einer Funktion zum Erstellen einer Instanz, die normalerweise nur ein einfacher Konstruktoraufruf ist\&. \fBkgendesignerplugin\fR erlaubt Entwicklern von Bibliotheken, die neue Bedienelemente bereitstellen, die Erstellung eines solchen Moduls ohne den gesamten zugeh\(:origen Boilerplate\-Code zu erstellen, indem eine einfache Beschreibungsdatei im Ini\-Stil bereitgestellt wird\&. .PP \fBkgendesignerplugin\fR verwendet sinnvolle Voreinstellungen f\(:ur die meisten Einstellungen, daher ist normalerweise nur eine minimale Konfiguration erforderlich\&. .SH "OPTIONEN" .PP \fB\-o \fR\fB\fIdatei\fR\fR .RS 4 Der Name der generierten C++\-Datei\&. Ist er nicht angegeben, wird \fIstdout\fR benutzt\&. .RE .PP \fB\-n \fR\fB\fIplugin\-name\fR\fR .RS 4 Nur zur Kompatibilit\(:at\&. Der Standardwert f\(:ur die Option PluginName in der Eingabedatei\&. .RE .PP \fB\-g \fR\fB\fIgroup\fR\fR .RS 4 Nur zur Kompatibilit\(:at\&. Der Standardwert f\(:ur die Option DefaultGroup in der Eingabedatei\&. .RE .PP \fB\-\-author\fR .RS 4 Zeigt Informationen \(:uber den Autor\&. .RE .PP \fB\-\-license\fR .RS 4 Zeigt Lizenz\-Informationen an\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 Zeigt einen kurzen Hilfetext\&. .RE .PP \fB\-v, \-\-version\fR .RS 4 Zeigt Versionsinformationen an\&. .RE .SH "DATEIFORMAT" .PP Die Eingabedatei ist eine Einrichtungsdatei im Ini\-Stile im Format, das von der Bibliothek KConfig unterst\(:utzt wird, und beschreibt eine Gruppe von Widgets\&. Sie enth\(:alt einen Abschnitt [Global] mit allgemeinen Informationen \(:uber das Modul und einen Abschnitt f\(:ur jedes Widget in diesem Modul\&. .PP Im Abschnitt [Global] kann es folgende Eintr\(:age geben: .PP \fIDefaultGroup\fR .RS 4 Der Standardwert f\(:ur den Eintrag \fIGroup\fR in den Klassenabschnitten\&. Voreinstellung ist Custom, wenn nicht die Option \fB\-g\fR angegeben ist\&. .RE .PP \fIIncludes\fR .RS 4 Eine (durch Komma getrennte) Liste der erforderlichen Includes (Standard: leer)\&. Beachten Sie, dass die Header\-Dateien f\(:ur die Bedienelemente, die sp\(:ater in der Datei angegeben werden, hier nicht aufgef\(:uhrt werden sollten\&. Stattdessen ist dies f\(:ur spezielle Header f\(:ur die eigene Verwendung des Moduls gedacht, wie die f\(:ur Klassen, die Vorschauen bereitstellen\&. .RE .PP \fIPluginName\fR .RS 4 Der Name der Haupt\-C++\-Klasse im Modul, Vorgabe WidgetsPlugin, wenn nicht die Option \fB\-n\fR angeben ist\&. .RE .PP Jede Klasse sollte einen eigenen Abschnitt [\fIClassName\fR] haben, der folgende Eintr\(:age enthalten kann: .PP \fICodeTemplate\fR .RS 4 Der R\(:uckgabewert der Funktion codeTemplate() des Moduls, der als \(Bqfuture use\(lq in Qt(TM)\-Designer gekennzeichnet ist, Vorgabewert leer\&. .RE .PP \fIConstructorArgs\fR .RS 4 Die Argumente, die an den Konstruktor der durch ImplClass angegebenen Klasse \(:ubergeben werden, m\(:ussen von Klammern umgeben sein (Standard: "(parent)")\&. Die einzige Variable, die garantiert verf\(:ugbar ist, ist \fIparent\fR, das ist der Elternteil QWidget, das von Qt(TM) Designer \(:ubergeben wird\&. .sp Dieser Eintrag wird ignoriert, wenn CreateWidget festgelegt ist\&. .RE .PP \fICreateWidget\fR .RS 4 Der notwendige Code, um eine Instanz des Bedienelements zu erzeugen: Standard: verwendet new, um eine Instanz der durch den Eintrag ImplClass angegebenen Klasse zu erzeugen, die Klasse zu erzeugen, wobei die durch ConstructorArgs angegebenen Argumente \(:ubergeben werden\&. Siehe die Hinweise zu ImplClass und ConstructorArgs\&. .RE .PP \fIDomXML\fR .RS 4 Eine XML\-UI\-Beschreibung des Bedienelements\&. Standard ist die Einstellung aus den Headern der Qt(TM)\-Designermodule\&. .RE .PP \fIGroup\fR .RS 4 Die Gruppe unter der das Bedienelement im Qt(TM)\-Designer angezeigt wird\&. Die Voreinstellung ist der Wert des Eintrags \fIDefaultGroup\fR im Abschnitt [Global]\&. .RE .PP \fIIconName\fR .RS 4 Die Bilddatei oder der Name des Standardsymbols, das als Symbol f\(:ur dieses Bedienelement in der Qt(TM) Designer\-Liste verwendet werden soll\&. (Standard: eine PNG\-Datei mit dem Namen des Abschnitts, wobei Doppelpunkte entfernt werden, im Verzeichnis "pics" einer kompilierten Ressourcendatei\&. Zum Beispiel :/pics/Foo\&.png im Abschnitt [Foo] oder :/pics/FooBar\&.png im Abschnitt [Foo::Bar])\&. .RE .PP \fIImplClass\fR .RS 4 Die Klasse, die verwendet werden soll, um eine Instanz des Bedienelements f\(:ur die Verwendung von Qt(TM)\-Designer (Standard: der Name des Abschnitts)\&. Beachten Sie, dass dies nicht tats\(:achlich die Klasse sein muss, die f\(:ur eine Endanwendung erzeugt werden w\(:urde\&. Das wird durch das DomXML bestimmt\&. .sp Dieser Eintrag wird ignoriert, wenn CreateWidget festgelegt ist\&. .RE .PP \fIIncludeFile\fR .RS 4 Die Header, der zur Verwendung dieses Bedienelements enthalten sein m\(:ussen\&. Standard: der kleingeschriebene Abschnittsnamen, wobei alle Doppelpunkte entfernt und "\&.h" angeh\(:angt werden\&. Zum Beispiel foo\&.h im Abschnitt [Foo] oder foobar\&.h im Abschnitt [Foo::Bar]\&. .RE .PP \fIIsContainer\fR .RS 4 Ob diese Bedienelement andere Bedienelement enthalten kann\&. Vorgabe ist false\&. .RE .PP \fIToolTip\fR .RS 4 Die Kurzinfo, die angezeigt wird, wenn der Mauszeiger \(:uber das Bedienelement in der Liste von Qt(TM)\-Designer gef\(:uhrt wird\&. Standard: der Name des Abschnitts, mit angeh\(:angtem " Widget"\&. Zum Beispiel: Foo Widget im Abschnitt [Foo])\&. .RE .PP \fIWhatsThis\fR .RS 4 Der \(BqWas ist das\(lq\-Text zum zugeh\(:origen Bedienelement in der Liste vom Qt(TM)\-\-Designer\&. Standard: der Name des Abschnitts, mit angeh\(:angtem " Widget"\&. Zum Beispiel: Foo Widget im Abschnitt [Foo])\&. .RE .SH "BEISPIELE" .PP Die einfachste Beschreibungsdatei kann so aussehen: .sp .if n \{\ .RS 4 .\} .nf [Foo] ToolTip=Displays foos [Bar] ToolTip=Bar editor .fi .if n \{\ .RE .\} .sp Beachten Sie, dass jede Klasse mindestens einen Schl\(:usselwert festlegen muss (ToolTip wurde zum Beispiel hier verwendet), ansonsten wird sie ignoriert\&. .PP Normalerweise wollen Sie zumindest den f\(:ur den Benutzer sichtbaren Text \(:andern, also die Eintr\(:age ToolTip, WhatsThis und Group\&. Zus\(:atzlich kann das Setzen des Modul\-Namens eine gute Idee sein, um m\(:ogliche Symbolkonflikte zu vermeiden und Debugger nicht zu verwirren, sowohl die Anwendung als auch die Person: .sp .if n \{\ .RS 4 .\} .nf [Global] PluginName=FooWidgets DefaultGroup=Display [Foo] ToolTip=Displays bears WhatsThis=An image widget that displays dancing bears [Bar] ToolTip=Bar editor WhatsThis=An editor interface for bars for bears Group=Editing .fi .if n \{\ .RE .\} .PP Komplexere Dateien k\(:onnen n\(:otig sein, wenn Sie Klassen mit Namensraum oder zus\(:atzliche Einstellungen, die vom Konstruktor unterst\(:utzt werden, wie zum Beispiel: .sp .if n \{\ .RS 4 .\} .nf [Global] PluginName=FooWidgets DefaultGroup=Foo [Foo::Bar] ToolTip=Displays bars WhatsThis=A widget that displays bars in a particular way IncludeFile=foo/bar\&.h IconName=:/previews/bar\&.png [Foo::Baz] IncludeFile=foo/baz\&.h ConstructorArgs=(Foo::Baz::SomeOption, parent) Group=Foo (Special) IsContainer=true IconName=:/previews/baz\&.png .fi .if n \{\ .RE .\} .PP Manchmal ben\(:otigen besonders komplexe Bedienelemente eine spezielle "Vorschauklassen"\-Implementierung f\(:ur die Verwendung in Qt(TM)\-Designer;\&. Dies kann eine Unterklasse des eigentlichen Bedienelements sein, die nur einige zus\(:atzliche Einstellungen vornimmt, oder es kann eine v\(:ollig andere Implementierung sein\&. .sp .if n \{\ .RS 4 .\} .nf [Global] Includes=foopreviews\&.h [FancyWidget] ImplClass=FancyWidgetPreview .fi .if n \{\ .RE .\} .sp .SH "SIEHE AUCH" .PP https://doc\&.qt\&.io/qt\-5/designer\-creating\-custom\-widgets\&.html .RS 4 Die Dokumentation zu Qt(TM)\-Designer f\(:ur die Erstellung von Modulen f\(:ur benutzerdefinierte Bedienelemente\&. .RE .SH "FEHLER" .PP Bitte verwenden Sie \m[blue]\fBbugs\&.kde\&.org\fR\m[]\&\s-2\u[1]\d\s+2 f\(:ur Fehlerberichte, schicken Sie keine E\-Mails direkt an die Autoren\&. .SH "AUTOREN" .PP \fBRichard Johnson\fR <\&rjohnson@kde\&.org\&> .RS 4 Schrieb die urspr\(:ungliche Dokumentation\&. .RE .PP \fBAlex Merry\fR <\&alexmerry@kde\&.org\&> .RS 4 Aktualisierte die Dokumentation f\(:ur KDE Frameworks 5\&. .RE .SH "FU\(ssNOTEN" .IP " 1." 4 bugs.kde.org .RS 4 \%https://bugs.kde.org .RE