NOM¶

kgendesignerplugin - Genera connectors de giny per al Qt(TM) Designer.

SINOPSI¶

kgendesignerplugin [OPCIONS...] fitxer

DESCRIPCIÓ¶

Els connectors de giny personalitzats per al Qt(TM) Designer solen seguir un patró estàndard, i les classes proporcionades pel connector proporcionen principalment informació estàtica, juntament amb la funció de crear una instància que normalment només és una crida de constructor simple. kgendesignerplugin permet als desenvolupadors de biblioteques que proporcionen ginys nous, el fet de crear un connector d'aquest tipus sense necessitat de crear tot el codi repetitiu associat, proporcionant un simple fitxer de descripció d'estil ini.

kgendesignerplugin tria els valors predeterminats per a la majoria de les opcions de configuració, de manera que sol ser necessària una configuració mínima.

OPCIONS¶

-o fitxer

-n nom_del_connector

-g grup

--author

--license

-h, --help

-v, --version

FORMAT DEL FITXER¶

El fitxer d'entrada és un fitxer de configuració d'estil ini (en concret, és el format implementat per l'entorn de treball KConfig), el qual descriu un conjunt de ginys. Conté una secció [Global], la qual proporciona informació general sobre el connector, i una secció per a cada giny que s'ha d'incloure en el connector.

La secció [Global] conté les següents entrades:

DefaultGroup

Includes

PluginName

Cada classe ha de tenir la seva pròpia secció [ClassName], la qual pot incloure les següents entrades:

CodeTemplate

ConstructorArgs

CreateWidget

DomXML

Group

IconName

ImplClass

IncludeFile

IsContainer

ToolTip

WhatsThis

EXEMPLES¶

El fitxer de descripció més senzill podria semblar-se a això:

[Foo]
ToolTip=Displays foos
[Bar]
ToolTip=Bar editor


    

Cal tenir en compte que cada classe almenys haurà de tenir un conjunt de claus (en aquest exemple s'utilitza ToolTip), en cas contrari s'ignorarà.

Usualment, voldreu canviar el text a almenys visible per l'usuari, el qual vol dir les entrades ToolTip, WhatsThis i Group. A més, establir el nom del connector pot ser una bona idea per a evitar possibles col⋅lisions de símbol i no confondre als depuradors (tant l'aplicació del depurador com la persona que realitza la depuració):

[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


    

Poden ser necessaris fitxers més complexos si teniu classes d'espais de nom o opcions addicionals que necessiten ser subministrades als constructors, per exemple:

[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


    

De vegades els ginys especialment complexos poden necessitar una implementació «classe de vista prèvia» especial per al seu ús en el Qt(TM) Designer. Aquesta podria ser una subclasse del giny real, la qual només faria alguna configuració addicional, o podria ser una implementació completament diferent.

[Global]
Includes=foopreviews.h
[FancyWidget]
ImplClass=FancyWidgetPreview


    

VEGEU TAMBɶ

https://doc.qt.io/qt-5/designer-creating-custom-widgets.html

ERRORS¶

Si us plau, empreu el Seguidor d'errors del KDE[1] (escriviu-hi en anglès) per a informar-ne, no envieu cap correu directament als autors.

AUTORS¶

Johnson, Richard <rjohnson@kde.org>

Merry, Alex <alexmerry@kde.org>

NOTES¶

1.

Seguidor d'errors del KDE