NAMN

kgendesignerplugin - Skapar grafiska instickskomponenter för Qt(TM) Designer.

SYNOPSIS

kgendesignerplugin [ VÄLJARE...] fil

BESKRIVNING

De anpassade insticksmodulerna för Qt(TM) Designer följer vanligtvis ett standardmönster, och klasserna som tillhandahålls av insticksmodulen tillhandahåller statisk information, tillsammans med en funktion för att skapa en instans som normalt bara är ett enkelt konstruktoranrop. kgendesignerplugin låter utvecklare av bibliotek som tillhandahåller nya grafiska komponenter skapa en sådan insticksmodul utan att skapa all tillhörande standardkod, genom att tillhandahålla en enkel beskrivningsfil med ini-stil.
kgendesignerplugin väljer rimliga standardvärden för de flesta inställningarna, så minimal inställning är oftast nödvändig.

VÄLJARE

-o fil
Namnet på den skapade C++ filen. Om inte angiven, används standardutmatningen.
-n insticksnamn
Tillhandahålls för kompatibilitet. Standardvärdet på alternativet PluginName i indatafilen.
-g grupp
Tillhandahålls för kompatibilitet. Standardvärdet på alternativet DefaultGroup i indatafilen.
--author
Visa information om upphovsman.
--license
Visa licensinformation.
-h, --help
Visa en kortfattad hjälptext.
-v , --version
Visa versionsinformation.

FILFORMAT

Indatafilen är en inställningsfil med ini-stil (mer specifikt använder den formatet som stöds av ramverket KConfig) som beskriver en uppsättning grafiska komponenter. Den innehåller sektionen [Global], som tillhandahåller allmän information om insticksmodulen, och en sektion för varje grafisk komponent som ska ingå i insticksmodulen.
Sektionen [Global] kan ha följande poster:
DefaultGroup
Standardvärdet för posten Group i klassektionen (standardvärde: "Custom", om inte väljaren -g anges).
Includes
En lista med deklarationsfiler som krävs (åtskilda med kommatecken, normalt tom). Observera att deklarationsfilerna för de grafiska komponenterna som specificeras senare i filen inte ska listas här, istället är detta till för särskilda deklarationsfiler för insticksmodulens egen användning, såsom de för klasser som tillhandahåller förhandsgranskningar.
PluginName
Namnet på den huvudsakliga C++ klassen i insticksmodulen (standardvärde: "WidgetsPlugin", om inte väljaren -n anges).
Varje klass ska ha sin egen sektion [ klassnamn], som kan innehålla följande poster:
CodeTemplate
Värdet som returneras av insticksmodulens funktion codeTemplate(), som är markerad för "framtida användning" av Qt(TM) Designer (standardvärde: tom).
ConstructorArgs
Argumentet att skicka till klassens konstruktor given av ImplClass. De måste vara omgivna av parenteser(standardvärde: "(parent)"). Den enda variabel som garanterat är tillgänglig är parent, som är den överliggande QWidget-klassen som skickas med av Qt(TM) Designer.
 
Den här posten ignoreras om CreateWidget är angivet.
CreateWidget
Koden som är nödvändig för att skapa en instans av den grafiska komponenten (standardvärde: använder new för att skapa en instans av klassen given av posten ImplClass, och skickar med argumenten som anges av ConstructorArgs). Se anmärkningarna för ImplClass och ConstructorArgs.
DomXML
En XML UI-beskrivning av den grafiska komponenten (standardvärde: de förvalda värden som tillhandahålls av Qt(TM) Designer deklarationsfiler för insticksmoduler).
Group
Grupp att visa den grafiska komponenten under i Qt(TM) Designer (standardvärde: värdet på posten DefaultGroup i sektionen [Global]).
IconName
Bildfilen eller standardikonnamnet att använda som ikon för den här grafiska komponenten i Qt(TM) Designers komponentlista (standardvärde: en PNG-fil namngiven med sektionsnamnet, med eventuella dubbla kolon borttagna, i katalogen "pics" i en inkompilerad resursfil, till exempel :/pics/Sektion.png för sektionen [Sektion], eller :/pics/SektionKlass.png för sektionen [Sektion::Klass]).
ImplClass
Klassen som ska användas för att skapa en instans av den grafiska komponenten för användning av Qt(TM) Designer (standardvärde: sektionsnamnet). Observera att det inte behöver vara klassen som ska skapas för en slutapplikation: Den bestäms av DomXML.
 
Den här posten ignoreras om CreateWidget är angivet.
IncludeFile
Deklarationsfilen som måste inkluderas för att använda den här grafiska komponenten (standardvärde: sektionsnamnet med små bokstäver, med eventuella kolon borttagna och ".h" tillagt sist, exempelvis sektion.h för sektionen [Sektion] eller sektionklass för sektionen [Sektion::Klass]).
IsContainer
Om den här grafiska komponenten kan innehålla andra grafiska komponenter (standardvärde false).
ToolTip
Verktygstipset att visa när musen hålls över den grafiska komponenten i Qt(TM) Designers komponentlista (standardvärde: sektionsnamnet med "Widget" tillagt sist, exempelvis Sektion Widget i sektionen [Sektion]).
WhatsThis
Vad är det här-texten som hör ihop med den grafiska komponenten i Qt(TM) Designer (standardvärde: sektionsnamnet med "Widget" tillagt sist, exempelvis Sektion Widget för sektionen [Sektion]).

EXEMPEL

Den enklast möjliga beskrivningsfilen kan se ut så här
 

[Foo]
ToolTip=Displays foos
[Bar]
ToolTip=Bar editor
 
Observera att varje klass måste ha minst en nyckeluppsättning (ToolTip användes i det här exemplet), annars ignoreras den.
Oftast vill man åtminstone ändra den användarsynliga texten, vilket betyder posterna ToolTipWhatsThis och Group. Dessutom kan det vara en bra idé att ange insticksmodulens namn för att förhindra möjliga symbolkollisioner och inte göra avlusare förvirrade (både avlusningsprogrammet och personen som avlusar).
 
[Global]
PluginName=MinaKomponenter
DefaultGroup=Display


[X]
ToolTip=Visar björnar
WhatsThis=En bildkomponent som visar dansande björnar


[Bar]
ToolTip=Bar-editor
WhatsThis=En editorgränssnitt för björnbarer
Group=Editing
Mer komplexa filer kan behövas om man exempelvis har klasser med namnrymder eller extra alternativ som måste skickas till konstruktorer.
 
[Global]
PluginName=MinaKomponenter
DefaultGroup=Grupp


[Grupp::Bar]
ToolTip=Visar barer
WhatsThis=En grafisk komponent som visar barer på ett visst sätt
IncludeFile=grupp/bar.h
IconName=:/förhandsgranskning/bar.png


[Grupp::Baz]
IncludeFile=grupp/baz.h
ConstructorArgs=(Grupp::Baz::Ett_alternativ, parent)
Group=Grupp (Special)
IsContainer=true
IconName=:/förhandsgranskning/baz.png
Ibland kan särskilt komplexa grafiska komponenter kräva en särskild implementering av en "förhandsgranskningsklass" för användning i Qt(TM) Designer. Det kan vara en delklass av den verkliga grafiska komponenten som bara gör en del extra inställningar, eller en helt annorlunda implementering.
 
[Global]
Includes=gruppförhandsgranskningar.h


[Snygg_komponent]
ImplClass=Snygg_komponent_förhandsgranskning
 

SE OCKSÅ

https://doc.qt.io/qt-5/designer-creating-custom-widgets.html
Qt(TM) Designer-dokumentationen om hur man skapar insticksmoduler för egna grafiska komponenter.

FEL

Använd KDE:s felspårningsverktyg[1] för att rapportera fel, skicka inte e-post direkt till upphovsmännen.

AUTHORS

Richard Johnson <[email protected]>
Skrev den ursprungliga dokumentationen.
Alex Merry <[email protected]>
Uppdaterade dokumentationen för KDE ramverk 5.

NOTER

1.
KDE:s felspårningsverktyg

Questions & Answers

Helpful answers and articles about kgendesignerplugin you may found on these sites:
Stack Overflow Server Fault Super User Unix & Linux Ask Ubuntu Network Engineering DevOps Raspberry Pi Webmasters Google Search