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 <rjohnson@kde.org>
           Skrev den ursprungliga dokumentationen.

       Alex Merry <alexmerry@kde.org>
           Uppdaterade dokumentationen för KDE ramverk 5.

NOTER

        1. KDE:s felspårningsverktyg
           https://bugs.kde.org

KDE Ramverk Ramverk 5.0                            2014-05-28                               KGENDESIGNERPLUGI(1)