'\" t
.\"     Title: \fBkgendesignerplugin\fR
.\"    Author: Johnson, Richard <rjohnson@kde.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 28 de maig de 2014
.\"    Manual: Frameworks del KDE: KDesignerPlugin
.\"    Source: Frameworks del KDE Frameworks 5.0
.\"  Language: Catalan
.\"
.TH "\FBKGENDESIGNERPLUGI" "1" "28 de maig de 2014" "Frameworks del KDE Frameworks" "Frameworks del KDE: KDesignerP"
.\" -----------------------------------------------------------------
.\" * 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 "NOM"
kgendesignerplugin \- Genera connectors de giny per al Qt(TM) Designer\&.
.SH "SINOPSI"
.HP \w'\fBkgendesignerplugin\fR\ 'u
\fBkgendesignerplugin\fR [\fIOPCIONS\fR...] \fIfitxer\fR
.SH "DESCRIPCI\('O"
.PP
Els connectors de giny personalitzats per al
Qt(TM)
Designer solen seguir un patr\('o est\(`andard, i les classes proporcionades pel connector proporcionen principalment informaci\('o est\(`atica, juntament amb la funci\('o de crear una inst\(`ancia que normalment nom\('es \('es una crida de constructor simple\&.
\fBkgendesignerplugin\fR
permet als desenvolupadors de biblioteques que proporcionen ginys nous, el fet de crear un connector d\*(Aqaquest tipus sense necessitat de crear tot el codi repetitiu associat, proporcionant un simple fitxer de descripci\('o d\*(Aqestil ini\&.
.PP
\fBkgendesignerplugin\fR
tria els valors predeterminats per a la majoria de les opcions de configuraci\('o, de manera que sol ser necess\(`aria una configuraci\('o m\('inima\&.
.SH "OPCIONS"
.PP
\fB\-o \fR\fB\fIfitxer\fR\fR
.RS 4
El nom per al fitxer C++ generat\&. Si no es dona, s\*(Aqutilitza la sortida est\(`andard (\fIstdout\fR)\&.
.RE
.PP
\fB\-n \fR\fB\fInom_del_connector\fR\fR
.RS 4
Es proporciona per compatibilitat\&. El valor predeterminat per a l\*(Aqopci\('o PluginName al fitxer d\*(Aqentrada\&.
.RE
.PP
\fB\-g \fR\fB\fIgrup\fR\fR
.RS 4
Es proporciona per compatibilitat\&. El valor predeterminat per a l\*(Aqopci\('o DefaultGroup al fitxer d\*(Aqentrada\&.
.RE
.PP
\fB\-\-author\fR
.RS 4
Mostra informaci\('o sobre l\*(Aqautor\&.
.RE
.PP
\fB\-\-license\fR
.RS 4
Mostra informaci\('o sobre la llic\(`encia\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
Mostra un text breu d\*(Aqajuda\&.
.RE
.PP
\fB\-v, \-\-version\fR
.RS 4
Mostra informaci\('o sobre la versi\('o\&.
.RE
.SH "FORMAT DEL FITXER"
.PP
El fitxer d\*(Aqentrada \('es un fitxer de configuraci\('o d\*(Aqestil ini (en concret, \('es el format implementat per l\*(Aqentorn de treball KConfig), el qual descriu un conjunt de ginys\&. Cont\('e una secci\('o
[Global], la qual proporciona informaci\('o general sobre el connector, i una secci\('o per a cada giny que s\*(Aqha d\*(Aqincloure en el connector\&.
.PP
La secci\('o
[Global]
cont\('e les seg\(:uents entrades:
.PP
\fIDefaultGroup\fR
.RS 4
El valor predeterminat per a l\*(Aqentrada
\fIGroup\fR
en les seccions de classe (predeterminat: \(FoCustom\(Fc, a menys que s\*(Aqindiqui l\*(Aqopci\('o
\fB\-g\fR)\&.
.RE
.PP
\fIIncludes\fR
.RS 4
Una llista (separada per comes) dels \(Foincludes\(Fc requerits (predeterminat: buida)\&. Cal tenir en compte que els fitxers de cap\(,calera per als ginys especificats m\('es endavant al fitxer no s\*(Aqhan de llistar aqu\('i\&. En canvi, aix\(`o \('es per a les cap\(,caleres especials per a l\*(Aq\('us propi del connector, com les de les classes que proporcionen vistes pr\(`evies\&.
.RE
.PP
\fIPluginName\fR
.RS 4
El nom de la classe de C++ principal en el connector (predeterminat: \(FoWidgetsPlugin\(Fc, a menys que s\*(Aqindiqui l\*(Aqopci\('o
\fB\-n\fR)\&.
.RE
.PP
Cada classe ha de tenir la seva pr\(`opia secci\('o
[\fIClassName\fR], la qual pot incloure les seg\(:uents entrades:
.PP
\fICodeTemplate\fR
.RS 4
El valor retornat per la funci\('o
codeTemplate()
del connector, la qual \('es marcada per a \(Fo\('us futur\(Fc pel
Qt(TM)
Designer (predeterminat: buida)\&.
.RE
.PP
\fIConstructorArgs\fR
.RS 4
Els arguments que s\*(Aqha de passar al constructor de la classe indicada per
ImplClass\&. Aquests han d\*(Aqestar envoltats entre par\(`entesis (predeterminat: \(Fo(parent)\(Fc)\&. L\*(Aq\('unica variable garantida que estar\(`a disponible \('es la
\fIparent\fR, la qual \('es la pare de
QWidget
passada pel
Qt(TM)
Designer\&.
.sp
Aquesta entrada ser\(`a ignorada si s\*(Aqestableix
CreateWidget\&.
.RE
.PP
\fICreateWidget\fR
.RS 4
El codi necessari per a crear una inst\(`ancia del giny (predeterminat: utilitza
new
per a crear una inst\(`ancia de la classe indicada per l\*(Aqentrada
ImplClass, passant els arguments especificats per
ConstructorArgs)\&. Vegeu les notes per a
ImplClass
i
ConstructorArgs\&.
.RE
.PP
\fIDomXML\fR
.RS 4
Una descripci\('o IU en
XML
del giny (predeterminat: el valor predeterminat proporcionat per les cap\(,caleres al connector del
Qt(TM)
Designer)\&.
.RE
.PP
\fIGroup\fR
.RS 4
El grup per a mostrar el giny sota el
Qt(TM)
Designer (predeterminat: el valor de l\*(Aqentrada
\fIDefaultGroup\fR
a la secci\('o
[Global])\&.
.RE
.PP
\fIIconName\fR
.RS 4
El fitxer d\*(Aqimatge o nom d\*(Aqicona est\(`andard que s\*(Aqutilitza com a icona per a aquest giny en la llista de ginys del
Qt(TM)
Designer (predeterminat: un fitxer PNG anomenat amb el nom de la secci\('o, eliminant qualsevol car\(`acter de dos punts, al directori \(Fopics\(Fc dins d\*(Aqun fitxer de recursos compilat\&. Per exemple,
:/pics/Foo\&.png
a la secci\('o
[Foo], o
:/pics/FooBar\&.png
a la secci\('o
[Foo::Bar])\&.
.RE
.PP
\fIImplClass\fR
.RS 4
La classe que s\*(Aqha d\*(Aqutilitzar per a crear una inst\(`ancia del giny per a l\*(Aq\('us del
Qt(TM)
Designer (predeterminat: el nom de la secci\('o)\&. Cal tenir en compte que aquest en realitat no ha de per qu\(`e ser la classe que es crearia per a una aplicaci\('o final: est\(`a determinat per la
DomXML\&.
.sp
Aquesta entrada ser\(`a ignorada si s\*(Aqestableix
CreateWidget\&.
.RE
.PP
\fIIncludeFile\fR
.RS 4
La cap\(,calera que s\*(Aqha d\*(Aqincloure per a utilitzar\-la amb aquest giny (predeterminat: la versi\('o en min\('uscules del nom de la secci\('o, eliminant qualsevol car\(`acter de dos punts i annexant \(Fo*\&.h\(Fc\&. Per exemple,
foo\&.h
a la secci\('o
[Foo], o
foobar\&.h
a la secci\('o
[Foo::Bar])\&.
.RE
.PP
\fIIsContainer\fR
.RS 4
Si aquest giny pot contenir altres ginys (predeterminat:
false)\&.
.RE
.PP
\fIToolTip\fR
.RS 4
El consell d\*(Aqeina que es mostrar\(`a quan es passi per sobre del giny a la llista de ginys del
Qt(TM)
Designer (predeterminat: el nom de la secci\('o, amb \(FoWidget\(Fc annexat\&. Per exemple,
Foo Widget
a la secci\('o
[Foo])\&.
.RE
.PP
\fIWhatsThis\fR
.RS 4
El text de \(FoQu\(`e \('es aix\(`o\(Fc associat amb el giny al
Qt(TM)
Designer (predeterminat: el nom de la secci\('o, amb \(FoWidget\(Fc annexat\&. Per exemple,
Foo Widget
a la secci\('o
[Foo])\&.
.RE
.SH "EXEMPLES"
.PP
El fitxer de descripci\('o m\('es senzill podria semblar\-se a aix\(`o:
.sp
.if n \{\
.RS 4
.\}
.nf

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

    
.fi
.if n \{\
.RE
.\}
.sp
Cal tenir en compte que cada classe almenys haur\(`a de tenir un conjunt de claus (en aquest exemple s\*(Aqutilitza
ToolTip), en cas contrari s\*(Aqignorar\(`a\&.
.PP
Usualment, voldreu canviar el text a almenys visible per l\*(Aqusuari, el qual vol dir les entrades
ToolTip,
WhatsThis
i
Group\&. A m\('es, establir el nom del connector pot ser una bona idea per a evitar possibles col\(mdlisions de s\('imbol i no confondre als depuradors (tant l\*(Aqaplicaci\('o del depurador com la persona que realitza la depuraci\('o):
.sp
.if n \{\
.RS 4
.\}
.nf
[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

    
.fi
.if n \{\
.RE
.\}
.PP
Poden ser necessaris fitxers m\('es complexos si teniu classes d\*(Aqespais de nom o opcions addicionals que necessiten ser subministrades als constructors, per exemple:
.sp
.if n \{\
.RS 4
.\}
.nf
[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

    
.fi
.if n \{\
.RE
.\}
.PP
De vegades els ginys especialment complexos poden necessitar una implementaci\('o \(Foclasse de vista pr\(`evia\(Fc especial per al seu \('us en el
Qt(TM)
Designer\&. Aquesta podria ser una subclasse del giny real, la qual nom\('es faria alguna configuraci\('o addicional, o podria ser una implementaci\('o completament diferent\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
Includes=foopreviews\&.h

[FancyWidget]
ImplClass=FancyWidgetPreview

    
.fi
.if n \{\
.RE
.\}
.sp
.SH "VEGEU TAMB\('E"
.PP
https://doc\&.qt\&.io/qt\-5/designer\-creating\-custom\-widgets\&.html
.RS 4
La documentaci\('o del
Qt(TM)
Designer sobre la creaci\('o de connectors per a ginys personalitzats\&.
.RE
.SH "ERRORS"
.PP
Si us plau, empreu el
\m[blue]\fBSeguidor d\*(Aqerrors del KDE\fR\m[]\&\s-2\u[1]\d\s+2
(escriviu\-hi en angl\(`es) per a informar\-ne, no envieu cap correu directament als autors\&.
.SH "AUTORS"
.PP
\fBJohnson, Richard\fR <\&rjohnson@kde\&.org\&>
.RS 4
Va escriure la documentaci\('o original\&.
.RE
.PP
\fBMerry, Alex\fR <\&alexmerry@kde\&.org\&>
.RS 4
Ha actualitzat la documentaci\('o al Frameworks 5 del KDE\&.
.RE
.SH "NOTES"
.IP " 1." 4
Seguidor d'errors del KDE
.RS 4
\%https://bugs.kde.org
.RE