KGENDESIGNERPLUGI(1) KDE ramverk: KDesignerPlugin KGENDESIGNERPLUGI(1) NAMN kgendesignerplugin - Skapar grafiska instickskomponenter for Qt(TM) Designer. SYNOPSIS kgendesignerplugin [VALJARE...] fil BESKRIVNING De anpassade insticksmodulerna for Qt(TM) Designer foljer vanligtvis ett standardmonster, och klasserna som tillhandahalls av insticksmodulen tillhandahaller statisk information, tillsammans med en funktion for att skapa en instans som normalt bara ar ett enkelt konstruktoranrop. kgendesignerplugin later utvecklare av bibliotek som tillhandahaller nya grafiska komponenter skapa en sadan insticksmodul utan att skapa all tillhorande standardkod, genom att tillhandahalla en enkel beskrivningsfil med ini-stil. kgendesignerplugin valjer rimliga standardvarden for de flesta installningarna, sa minimal installning ar oftast nodvandig. VALJARE -o fil Namnet pa den skapade C++ filen. Om inte angiven, anvands standardutmatningen. -n insticksnamn Tillhandahalls for kompatibilitet. Standardvardet pa alternativet PluginName i indatafilen. -g grupp Tillhandahalls for kompatibilitet. Standardvardet pa alternativet DefaultGroup i indatafilen. --author Visa information om upphovsman. --license Visa licensinformation. -h, --help Visa en kortfattad hjalptext. -v , --version Visa versionsinformation. FILFORMAT Indatafilen ar en installningsfil med ini-stil (mer specifikt anvander den formatet som stods av ramverket KConfig) som beskriver en uppsattning grafiska komponenter. Den innehaller sektionen [Global], som tillhandahaller allman information om insticksmodulen, och en sektion for varje grafisk komponent som ska inga i insticksmodulen. Sektionen [Global] kan ha foljande poster: DefaultGroup Standardvardet for posten Group i klassektionen (standardvarde: "Custom", om inte valjaren -g anges). Includes En lista med deklarationsfiler som kravs (atskilda med kommatecken, normalt tom). Observera att deklarationsfilerna for de grafiska komponenterna som specificeras senare i filen inte ska listas har, istallet ar detta till for sarskilda deklarationsfiler for insticksmodulens egen anvandning, sasom de for klasser som tillhandahaller forhandsgranskningar. PluginName Namnet pa den huvudsakliga C++ klassen i insticksmodulen (standardvarde: "WidgetsPlugin", om inte valjaren -n anges). Varje klass ska ha sin egen sektion [klassnamn], som kan innehalla foljande poster: CodeTemplate Vardet som returneras av insticksmodulens funktion codeTemplate(), som ar markerad for "framtida anvandning" av Qt(TM) Designer (standardvarde: tom). ConstructorArgs Argumentet att skicka till klassens konstruktor given av ImplClass. De maste vara omgivna av parenteser(standardvarde: "(parent)"). Den enda variabel som garanterat ar tillganglig ar parent, som ar den overliggande QWidget-klassen som skickas med av Qt(TM) Designer. Den har posten ignoreras om CreateWidget ar angivet. CreateWidget Koden som ar nodvandig for att skapa en instans av den grafiska komponenten (standardvarde: anvander new for att skapa en instans av klassen given av posten ImplClass, och skickar med argumenten som anges av ConstructorArgs). Se anmarkningarna for ImplClass och ConstructorArgs. DomXML En XML UI-beskrivning av den grafiska komponenten (standardvarde: de forvalda varden som tillhandahalls av Qt(TM) Designer deklarationsfiler for insticksmoduler). Group Grupp att visa den grafiska komponenten under i Qt(TM) Designer (standardvarde: vardet pa posten DefaultGroup i sektionen [Global]). IconName Bildfilen eller standardikonnamnet att anvanda som ikon for den har grafiska komponenten i Qt(TM) Designers komponentlista (standardvarde: en PNG-fil namngiven med sektionsnamnet, med eventuella dubbla kolon borttagna, i katalogen "pics" i en inkompilerad resursfil, till exempel :/pics/Sektion.png for sektionen [Sektion], eller :/pics/SektionKlass.png for sektionen [Sektion::Klass]). ImplClass Klassen som ska anvandas for att skapa en instans av den grafiska komponenten for anvandning av Qt(TM) Designer (standardvarde: sektionsnamnet). Observera att det inte behover vara klassen som ska skapas for en slutapplikation: Den bestams av DomXML. Den har posten ignoreras om CreateWidget ar angivet. IncludeFile Deklarationsfilen som maste inkluderas for att anvanda den har grafiska komponenten (standardvarde: sektionsnamnet med sma bokstaver, med eventuella kolon borttagna och ".h" tillagt sist, exempelvis sektion.h for sektionen [Sektion] eller sektionklass for sektionen [Sektion::Klass]). IsContainer Om den har grafiska komponenten kan innehalla andra grafiska komponenter (standardvarde false). ToolTip Verktygstipset att visa nar musen halls over den grafiska komponenten i Qt(TM) Designers komponentlista (standardvarde: sektionsnamnet med "Widget" tillagt sist, exempelvis Sektion Widget i sektionen [Sektion]). WhatsThis Vad ar det har-texten som hor ihop med den grafiska komponenten i Qt(TM) Designer (standardvarde: sektionsnamnet med "Widget" tillagt sist, exempelvis Sektion Widget for sektionen [Sektion]). EXEMPEL Den enklast mojliga beskrivningsfilen kan se ut sa har [Foo] ToolTip=Displays foos [Bar] ToolTip=Bar editor Observera att varje klass maste ha minst en nyckeluppsattning (ToolTip anvandes i det har exemplet), annars ignoreras den. Oftast vill man atminstone andra den anvandarsynliga texten, vilket betyder posterna ToolTipWhatsThis och Group. Dessutom kan det vara en bra ide att ange insticksmodulens namn for att forhindra mojliga symbolkollisioner och inte gora avlusare forvirrade (bade avlusningsprogrammet och personen som avlusar). [Global] PluginName=MinaKomponenter DefaultGroup=Display [X] ToolTip=Visar bjornar WhatsThis=En bildkomponent som visar dansande bjornar [Bar] ToolTip=Bar-editor WhatsThis=En editorgranssnitt for bjornbarer Group=Editing Mer komplexa filer kan behovas om man exempelvis har klasser med namnrymder eller extra alternativ som maste skickas till konstruktorer. [Global] PluginName=MinaKomponenter DefaultGroup=Grupp [Grupp::Bar] ToolTip=Visar barer WhatsThis=En grafisk komponent som visar barer pa ett visst satt IncludeFile=grupp/bar.h IconName=:/forhandsgranskning/bar.png [Grupp::Baz] IncludeFile=grupp/baz.h ConstructorArgs=(Grupp::Baz::Ett_alternativ, parent) Group=Grupp (Special) IsContainer=true IconName=:/forhandsgranskning/baz.png Ibland kan sarskilt komplexa grafiska komponenter krava en sarskild implementering av en "forhandsgranskningsklass" for anvandning i Qt(TM) Designer. Det kan vara en delklass av den verkliga grafiska komponenten som bara gor en del extra installningar, eller en helt annorlunda implementering. [Global] Includes=gruppforhandsgranskningar.h [Snygg_komponent] ImplClass=Snygg_komponent_forhandsgranskning SE OCKSA https://doc.qt.io/qt-5/designer-creating-custom-widgets.html Qt(TM) Designer-dokumentationen om hur man skapar insticksmoduler for egna grafiska komponenter. FEL Anvand KDE:s felsparningsverktyg[1] for att rapportera fel, skicka inte e-post direkt till upphovsmannen. AUTHORS Richard Johnson Skrev den ursprungliga dokumentationen. Alex Merry Uppdaterade dokumentationen for KDE ramverk 5. NOTER 1. KDE:s felsparningsverktyg https://bugs.kde.org KDE Ramverk Ramverk 5.0 2014-05-28 KGENDESIGNERPLUGI(1)