'\" t
.\"     Title: \fBkgendesignerplugin\fR
.\"    Author: Richard Johnson <rjohnson@kde.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2014-05-28
.\"    Manual: KDE ramverk: KDesignerPlugin
.\"    Source: KDE Ramverk Ramverk 5.0
.\"  Language: Swedish
.\"
.TH "\FBKGENDESIGNERPLUGI" "1" "2014\-05\-28" "KDE Ramverk Ramverk 5.0" "KDE ramverk: KDesignerPlugin"
.\" -----------------------------------------------------------------
.\" * 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 "NAMN"
kgendesignerplugin \- Skapar grafiska instickskomponenter f\(:or Qt(TM) Designer\&.
.SH "SYNOPSIS"
.HP \w'\fBkgendesignerplugin\fR\ 'u
\fBkgendesignerplugin\fR [\fIV\(:ALJARE\fR...] \fIfil\fR
.SH "BESKRIVNING"
.PP
De anpassade insticksmodulerna f\(:or
Qt(TM)
Designer f\(:oljer vanligtvis ett standardm\(:onster, och klasserna som tillhandah\(oalls av insticksmodulen tillhandah\(oaller statisk information, tillsammans med en funktion f\(:or att skapa en instans som normalt bara \(:ar ett enkelt konstruktoranrop\&.
\fBkgendesignerplugin\fR
l\(oater utvecklare av bibliotek som tillhandah\(oaller nya grafiska komponenter skapa en s\(oadan insticksmodul utan att skapa all tillh\(:orande standardkod, genom att tillhandah\(oalla en enkel beskrivningsfil med ini\-stil\&.
.PP
\fBkgendesignerplugin\fR
v\(:aljer rimliga standardv\(:arden f\(:or de flesta inst\(:allningarna, s\(oa minimal inst\(:allning \(:ar oftast n\(:odv\(:andig\&.
.SH "V\(:ALJARE"
.PP
\fB\-o \fR\fB\fIfil\fR\fR
.RS 4
Namnet p\(oa den skapade C++ filen\&. Om inte angiven, anv\(:ands
\fIstandardutmatningen\fR\&.
.RE
.PP
\fB\-n \fR\fB\fIinsticksnamn\fR\fR
.RS 4
Tillhandah\(oalls f\(:or kompatibilitet\&. Standardv\(:ardet p\(oa alternativet PluginName i indatafilen\&.
.RE
.PP
\fB\-g \fR\fB\fIgrupp\fR\fR
.RS 4
Tillhandah\(oalls f\(:or kompatibilitet\&. Standardv\(:ardet p\(oa alternativet DefaultGroup i indatafilen\&.
.RE
.PP
\fB\-\-author\fR
.RS 4
Visa information om upphovsman\&.
.RE
.PP
\fB\-\-license\fR
.RS 4
Visa licensinformation\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
Visa en kortfattad hj\(:alptext\&.
.RE
.PP
\fB\-v , \-\-version\fR
.RS 4
Visa versionsinformation\&.
.RE
.SH "FILFORMAT"
.PP
Indatafilen \(:ar en inst\(:allningsfil med ini\-stil (mer specifikt anv\(:ander den formatet som st\(:ods av ramverket KConfig) som beskriver en upps\(:attning grafiska komponenter\&. Den inneh\(oaller sektionen
[Global], som tillhandah\(oaller allm\(:an information om insticksmodulen, och en sektion f\(:or varje grafisk komponent som ska ing\(oa i insticksmodulen\&.
.PP
Sektionen
[Global]
kan ha f\(:oljande poster:
.PP
\fIDefaultGroup\fR
.RS 4
Standardv\(:ardet f\(:or posten
\fIGroup\fR
i klassektionen (standardv\(:arde: "Custom", om inte v\(:aljaren
\fB\-g\fR
anges)\&.
.RE
.PP
\fIIncludes\fR
.RS 4
En lista med deklarationsfiler som kr\(:avs (\(oatskilda med kommatecken, normalt tom)\&. Observera att deklarationsfilerna f\(:or de grafiska komponenterna som specificeras senare i filen inte ska listas h\(:ar, ist\(:allet \(:ar detta till f\(:or s\(:arskilda deklarationsfiler f\(:or insticksmodulens egen anv\(:andning, s\(oasom de f\(:or klasser som tillhandah\(oaller f\(:orhandsgranskningar\&.
.RE
.PP
\fIPluginName\fR
.RS 4
Namnet p\(oa den huvudsakliga C++ klassen i insticksmodulen (standardv\(:arde: "WidgetsPlugin", om inte v\(:aljaren
\fB\-n\fR
anges)\&.
.RE
.PP
Varje klass ska ha sin egen sektion
[\fIklassnamn\fR], som kan inneh\(oalla f\(:oljande poster:
.PP
\fICodeTemplate\fR
.RS 4
V\(:ardet som returneras av insticksmodulens funktion
codeTemplate(), som \(:ar markerad f\(:or "framtida anv\(:andning" av
Qt(TM)
Designer (standardv\(:arde: tom)\&.
.RE
.PP
\fIConstructorArgs\fR
.RS 4
Argumentet att skicka till klassens konstruktor given av
ImplClass\&. De m\(oaste vara omgivna av parenteser(standardv\(:arde: "(parent)")\&. Den enda variabel som garanterat \(:ar tillg\(:anglig \(:ar
\fIparent\fR, som \(:ar den \(:overliggande
QWidget\-klassen som skickas med av
Qt(TM)
Designer\&.
.sp
Den h\(:ar posten ignoreras om
CreateWidget
\(:ar angivet\&.
.RE
.PP
\fICreateWidget\fR
.RS 4
Koden som \(:ar n\(:odv\(:andig f\(:or att skapa en instans av den grafiska komponenten (standardv\(:arde: anv\(:ander
new
f\(:or att skapa en instans av klassen given av posten
ImplClass, och skickar med argumenten som anges av
ConstructorArgs)\&. Se anm\(:arkningarna f\(:or
ImplClass
och
ConstructorArgs\&.
.RE
.PP
\fIDomXML\fR
.RS 4
En
XML
UI\-beskrivning av den grafiska komponenten (standardv\(:arde: de f\(:orvalda v\(:arden som tillhandah\(oalls av
Qt(TM)
Designer deklarationsfiler f\(:or insticksmoduler)\&.
.RE
.PP
\fIGroup\fR
.RS 4
Grupp att visa den grafiska komponenten under i
Qt(TM)
Designer (standardv\(:arde: v\(:ardet p\(oa posten
\fIDefaultGroup\fR
i sektionen
[Global])\&.
.RE
.PP
\fIIconName\fR
.RS 4
Bildfilen eller standardikonnamnet att anv\(:anda som ikon f\(:or den h\(:ar grafiska komponenten i
Qt(TM)
Designers komponentlista (standardv\(:arde: en PNG\-fil namngiven med sektionsnamnet, med eventuella dubbla kolon borttagna, i katalogen "pics" i en inkompilerad resursfil, till exempel
:/pics/Sektion\&.png
f\(:or sektionen
[Sektion], eller
:/pics/SektionKlass\&.png
f\(:or sektionen
[Sektion::Klass])\&.
.RE
.PP
\fIImplClass\fR
.RS 4
Klassen som ska anv\(:andas f\(:or att skapa en instans av den grafiska komponenten f\(:or anv\(:andning av
Qt(TM)
Designer (standardv\(:arde: sektionsnamnet)\&. Observera att det inte beh\(:over vara klassen som ska skapas f\(:or en slutapplikation: Den best\(:ams av
DomXML\&.
.sp
Den h\(:ar posten ignoreras om
CreateWidget
\(:ar angivet\&.
.RE
.PP
\fIIncludeFile\fR
.RS 4
Deklarationsfilen som m\(oaste inkluderas f\(:or att anv\(:anda den h\(:ar grafiska komponenten (standardv\(:arde: sektionsnamnet med sm\(oa bokst\(:aver, med eventuella kolon borttagna och "\&.h" tillagt sist, exempelvis
sektion\&.h
f\(:or sektionen
[Sektion]
eller
sektionklass
f\(:or sektionen
[Sektion::Klass])\&.
.RE
.PP
\fIIsContainer\fR
.RS 4
Om den h\(:ar grafiska komponenten kan inneh\(oalla andra grafiska komponenter (standardv\(:arde
false)\&.
.RE
.PP
\fIToolTip\fR
.RS 4
Verktygstipset att visa n\(:ar musen h\(oalls \(:over den grafiska komponenten i
Qt(TM)
Designers komponentlista (standardv\(:arde: sektionsnamnet med "Widget" tillagt sist, exempelvis
Sektion Widget
i sektionen
[Sektion])\&.
.RE
.PP
\fIWhatsThis\fR
.RS 4
Vad \(:ar det h\(:ar\-texten som h\(:or ihop med den grafiska komponenten i
Qt(TM)
Designer (standardv\(:arde: sektionsnamnet med "Widget" tillagt sist, exempelvis
Sektion Widget
f\(:or sektionen
[Sektion])\&.
.RE
.SH "EXEMPEL"
.PP
Den enklast m\(:ojliga beskrivningsfilen kan se ut s\(oa h\(:ar
.sp
.if n \{\
.RS 4
.\}
.nf

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

    
.fi
.if n \{\
.RE
.\}
.sp
Observera att varje klass m\(oaste ha minst en nyckelupps\(:attning (ToolTip
anv\(:andes i det h\(:ar exemplet), annars ignoreras den\&.
.PP
Oftast vill man \(oatminstone \(:andra den anv\(:andarsynliga texten, vilket betyder posterna
ToolTipWhatsThis
och
Group\&. Dessutom kan det vara en bra id\('e att ange insticksmodulens namn f\(:or att f\(:orhindra m\(:ojliga symbolkollisioner och inte g\(:ora avlusare f\(:orvirrade (b\(oade avlusningsprogrammet och personen som avlusar)\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
PluginName=MinaKomponenter
DefaultGroup=Display

[X]
ToolTip=Visar bj\(:ornar
WhatsThis=En bildkomponent som visar dansande bj\(:ornar

[Bar]
ToolTip=Bar\-editor
WhatsThis=En editorgr\(:anssnitt f\(:or bj\(:ornbarer
Group=Editing

    
.fi
.if n \{\
.RE
.\}
.PP
Mer komplexa filer kan beh\(:ovas om man exempelvis har klasser med namnrymder eller extra alternativ som m\(oaste skickas till konstruktorer\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
PluginName=MinaKomponenter
DefaultGroup=Grupp

[Grupp::Bar]
ToolTip=Visar barer
WhatsThis=En grafisk komponent som visar barer p\(oa ett visst s\(:att
IncludeFile=grupp/bar\&.h
IconName=:/f\(:orhandsgranskning/bar\&.png

[Grupp::Baz]
IncludeFile=grupp/baz\&.h
ConstructorArgs=(Grupp::Baz::Ett_alternativ, parent)
Group=Grupp (Special)
IsContainer=true
IconName=:/f\(:orhandsgranskning/baz\&.png

    
.fi
.if n \{\
.RE
.\}
.PP
Ibland kan s\(:arskilt komplexa grafiska komponenter kr\(:ava en s\(:arskild implementering av en "f\(:orhandsgranskningsklass" f\(:or anv\(:andning i
Qt(TM)
Designer\&. Det kan vara en delklass av den verkliga grafiska komponenten som bara g\(:or en del extra inst\(:allningar, eller en helt annorlunda implementering\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
Includes=gruppf\(:orhandsgranskningar\&.h

[Snygg_komponent]
ImplClass=Snygg_komponent_f\(:orhandsgranskning

    
.fi
.if n \{\
.RE
.\}
.sp
.SH "SE OCKS\(oA"
.PP
https://doc\&.qt\&.io/qt\-5/designer\-creating\-custom\-widgets\&.html
.RS 4
Qt(TM)
Designer\-dokumentationen om hur man skapar insticksmoduler f\(:or egna grafiska komponenter\&.
.RE
.SH "FEL"
.PP
Anv\(:and
\m[blue]\fBKDE:s felsp\(oarningsverktyg\fR\m[]\&\s-2\u[1]\d\s+2
f\(:or att rapportera fel, skicka inte e\-post direkt till upphovsm\(:annen\&.
.SH "AUTHORS"
.PP
\fBRichard Johnson\fR <\&rjohnson@kde\&.org\&>
.RS 4
Skrev den ursprungliga dokumentationen\&.
.RE
.PP
\fBAlex Merry\fR <\&alexmerry@kde\&.org\&>
.RS 4
Uppdaterade dokumentationen f\(:or KDE ramverk 5\&.
.RE
.SH "NOTER"
.IP " 1." 4
KDE:s felsp\(oarningsverktyg
.RS 4
\%https://bugs.kde.org
.RE