'\" 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 Frameworks: KDesignerPlugin
.\"    Source: KDE Frameworks Frameworks 5.0
.\"  Language: Italian
.\"
.TH "\FBKGENDESIGNERPLUGI" "1" "2014\-05\-28" "KDE Frameworks Frameworks 5.0" "KDE Frameworks: KDesignerPlugi"
.\" -----------------------------------------------------------------
.\" * 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 "NOME"
kgendesignerplugin \- Genera estensioni di oggetti per Qt(TM) Designer\&.
.SH "SINOSSI"
.HP \w'\fBkgendesignerplugin\fR\ 'u
\fBkgendesignerplugin\fR [\fIOPZIONI\fR...] \fIfile\fR
.SH "DESCRIZIONE"
.PP
Le estensioni per oggetti personalizzati di
Qt(TM)
Designer seguono solitamente uno schema predefinito, e le classi fornite dall\*(Aqestensione forniscono per lo pi\(`u informazioni statiche, oltre alla funzione per creare un\*(Aqistanza, che \(`e normalmente una semplice chiamata a un costruttore\&.
\fBkgendesignerplugin\fR
permette agli sviluppatori di librerie di fornire nuovi oggetti per creare una tale estensione senza creare tutto il codice di routine, ma fornendo invece un semplice file descrittivo in stile ini\&.
.PP
\fBkgendesignerplugin\fR
sceglie valori predefiniti ragionevoli per la maggior parte delle impostazioni, per cui normalmente \(`e necessaria solo una configurazione minimale\&.
.SH "OPZIONI"
.PP
\fB\-o \fR\fB\fIfile\fR\fR
.RS 4
Il nome per il file C++ generato\&. Se non viene fornito, verr\(`a usato
\fIstdout\fR\&.
.RE
.PP
\fB\-n \fR\fB\fInome\-estensione\fR\fR
.RS 4
Disponibile per compatibilit\(`a\&. Il valore predefinito per l\*(Aqopzione PluginName nel file di input\&.
.RE
.PP
\fB\-g \fR\fB\fIgruppo\fR\fR
.RS 4
Disponibile per compatibilit\(`a\&. Il valore predefinito per l\*(Aqopzione DefaultGroup nel file di input\&.
.RE
.PP
\fB\-\-author\fR
.RS 4
Mostra le informazioni sull\*(Aqautore\&.
.RE
.PP
\fB\-\-license\fR
.RS 4
Mostra le informazioni sulla licenza\&.
.RE
.PP
\fB\-h, \-\-help\fR
.RS 4
Mostra un breve testo di aiuto\&.
.RE
.PP
\fB\-v , \-\-version\fR
.RS 4
Mostra le informazioni sulla versione\&.
.RE
.SH "FORMATO DEI FILE"
.PP
Il file di input \(`e un file di configurazione di tipo INI (in particolare, \(`e nel formato supportato dal framework KConfig) che descrive un insieme di oggetti\&. Contiene una sezione
[Global], che fornisce informazioni generali sull\*(Aqestensione, ed una sezione per ogni oggetto che deve essere incluso nell\*(Aqestensione\&.
.PP
La sezione
[Global]
pu\(`o avere le seguenti voci:
.PP
\fIDefaultGroup\fR
.RS 4
Il valore predefinito per la voce
\fIGroup\fR
nelle sezioni delle classi (valore predefinito: "Custom", a meno che l\*(Aqopzione
\fB\-g\fR
non sia stata fornita)\&.
.RE
.PP
\fIIncludes\fR
.RS 4
Un elenco (separato da virgole) di file da includere richiesti (valore predefinito: vuoto)\&. Nota come i file di intestazione per gli oggetti specificati successivamente nel file non vanno elencati qui; questo elenco \(`e per le intestazioni speciali usate internamente dall\*(Aqestensione, come quelli per le classi che forniscono le anteprime\&.
.RE
.PP
\fIPluginName\fR
.RS 4
Il nome della classe C++ principale nell\*(Aqestensione (valore predefinito: "WidgetsPlugin", a meno che l\*(Aqopzione
\fB\-n\fR
non sia stata specificata)\&.
.RE
.PP
Ogni classe dovrebbe avere la propria sezione
[\fIClassName\fR], che pu\(`o includere le seguenti voci:
.PP
\fICodeTemplate\fR
.RS 4
Il valore restituito dalla funzione
codeTemplate()
dell\*(Aqestensione, che \(`e segnata per "uso futuro" da
Qt(TM)
Designer (predefinito: vuoto)\&.
.RE
.PP
\fIConstructorArgs\fR
.RS 4
Gli argomenti da passare al costruttore della classe fornito da
ImplClass: questi devono essere racchiusi tra parentesi (valore predefinito:
(parent))\&. L\*(Aqunica variabile di cui \(`e garantita la presenza \(`e
\fIparent\fR, che \(`e l\*(Aqoggetto
QWidget
genitore passato da
Qt(TM)
Designer\&.
.sp
Questa voce \(`e ignorata se
CreateWidget
\(`e impostato\&.
.RE
.PP
\fICreateWidget\fR
.RS 4
Il codice necessario per creare un\*(Aqistanza dell\*(Aqoggetto (comportamento predefinito: usa
new
per creare un\*(Aqistanza della classe specificata dalla voce
ImplClass, passando gli argomenti specificati da
ConstructorArgs)\&. Consultare le note per
ImplClass
e
ConstructorArgs\&.
.RE
.PP
\fIDomXML\fR
.RS 4
Una descrizione
XML
UI dell\*(Aqoggetto (valore predefinito: quanto fornito dalle intestazioni dell\*(Aqestensione per
Qt(TM)
Designer)\&.
.RE
.PP
\fIGroup\fR
.RS 4
Il gruppo in cui mostrare l\*(Aqoggetto in
Qt(TM)
Designer (valore predefinito: il valore della voce
\fIDefaultGroup\fR
nella sezione
[Global])\&.
.RE
.PP
\fIIconName\fR
.RS 4
Il file di immagine o il nome standard di icona da usare come icona per questo oggetto nell\*(Aqelenco degli oggetti di
Qt(TM)
Designer (valore predefinito: un file PNG chiamato come il nome della sezione ma senza doppi due punti, nella directory \(Fopics\(Fc di un file di risorse integrato; ad esempio,
:/pics/Foo\&.png
nella sezione
[Foo], o
:/pics/FooBar\&.png
nella sezione
[Foo::Bar])\&.
.RE
.PP
\fIImplClass\fR
.RS 4
La classe che dovrebbe essere usata per creare un\*(Aqistanza dell\*(Aqoggetto per l\*(Aquso in
Qt(TM)
Designer (valore predefinito: il nome della sezione)\&. Si noti come questa non deve essere necessariamente la classe che verrebbe creata per l\*(Aqapplicazione finale: questo viene stabilito dal valore di
DomXML\&.
.sp
Questa voce \(`e ignorata se
CreateWidget
\(`e impostato\&.
.RE
.PP
\fIIncludeFile\fR
.RS 4
L\*(Aqintestazione che \(`e necessario includere per usare questo oggetto (valore predefinito: la versione in minuscolo del nome della sezione, con i due punti rimossi e \(Fo\&.h\(Fc aggiunto alla fine; ad esempio,
foo\&.h
nella sezione
[Foo], o
foobar\&.h
nella sezione
[Foo::Bar])\&.
.RE
.PP
\fIIsContainer\fR
.RS 4
Se questo oggetto possa contenerne altri (valore predefinito:
false)\&.
.RE
.PP
\fIToolTip\fR
.RS 4
Il suggerimento da mostrare quando il mouse passa sull\*(Aqoggetto nell\*(Aqelenco degli oggetti di
Qt(TM)
Designer (valore predefinito: il nome della sezione, con \(Fo Widget\(Fc aggiunto alla fine; ad esempio
Foo Widget
nella sezione
[Foo])\&.
.RE
.PP
\fIWhatsThis\fR
.RS 4
Il testo \(FoChe cos\*(Aq\(`e\(Fc associato all\*(Aqoggetto in
Qt(TM)
Designer (valore predefinito: il nome della sezione, con \(Fo Widget\(Fc aggiunto alla fine; ad esempio,
Foo Widget
nella sezione
[Foo])\&.
.RE
.SH "ESEMPI"
.PP
Il file di descrizione pi\(`u semplice potrebbe somigliare a:
.sp
.if n \{\
.RS 4
.\}
.nf

[Foo]
ToolTip=Mostra foo
[Bar]
ToolTip=Editor di qualcosa

    
.fi
.if n \{\
.RE
.\}
.sp
Si noti come ogni classe debba avere almeno una chiave impostata (in questo esempio \(`e stata usata
ToolTip), altrimenti la classe verr\(`a ignorata\&.
.PP
Normalmente vorrai cambiare almeno il testo visibile all\*(Aqutente, che vuol dire le voci
ToolTip,
WhatsThis
e
Group\&. Inoltre, impostare il nome dell\*(Aqestensione pu\(`o essere una buona idea per prevenire possibili conflitti di simboli e non confondere i debugger (sia l\*(Aqapplicazione debugger che la persona che effettua il debug):
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
PluginName=FooWidgets
DefaultGroup=Display

[Foo]
ToolTip=Mostra orsi
WhatsThis=Un\*(Aqoggetto immagine che mostra orsi danzanti

[Bar]
ToolTip=Editor qualcosa
WhatsThis=Un\*(Aqinterfaccia editor per qualcosa per orsi
Group=Editing

    
.fi
.if n \{\
.RE
.\}
.PP
Dei file pi\(`u complessi potrebbero essere necessari se ci fossero classi con namespace oppure opzioni aggiuntive che debbano essere fornite ai costruttori, ad esempio:
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
PluginName=FooWidgets
DefaultGroup=Foo

[Foo::Bar]
ToolTip=Mostra qualcosa
WhatsThis=Un oggetto che mostra qualcosa in modo peculiare
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
A volte degli oggetti particolarmente complessi potrebbero aver bisogno di un\*(Aqimplementazione di una speciale \(Foclasse di anteprima\(Fc per l\*(Aquso in
Qt(TM)
Designer; questa potrebbe essere una sottoclasse di un vero oggetto che esegue delle inizializzazioni aggiuntive, o potrebbe essere un\*(Aqimplementazione completamente diversa\&.
.sp
.if n \{\
.RS 4
.\}
.nf
[Global]
Includes=foopreviews\&.h

[FancyWidget]
ImplClass=FancyWidgetPreview

    
.fi
.if n \{\
.RE
.\}
.sp
.SH "VEDI ANCHE"
.PP
https://doc\&.qt\&.io/qt\-5/designer\-creating\-custom\-widgets\&.html
.RS 4
La documentazione di
Qt(TM)
Designer sulla creazione di estensioni per oggetti personalizzati\&.
.RE
.SH "ERRORI"
.PP
Usa
\m[blue]\fBil sito di gestione dei bug di KDE\fR\m[]\&\s-2\u[1]\d\s+2
per segnalarli, non mandare un messaggio direttamente agli autori\&.
.SH "AUTORI"
.PP
\fBRichard Johnson\fR <\&rjohnson@kde\&.org\&>
.RS 4
Ha scritto la documentazione originale\&.
.RE
.PP
\fBAlex Merry\fR <\&alexmerry@kde\&.org\&>
.RS 4
Ha aggiornato la documentazione per KDE Frameworks 5\&.
.RE
.SH "NOTE"
.IP " 1." 4
il sito di gestione dei bug di KDE
.RS 4
\%https://bugs.kde.org
.RE