'\" t .\" Title: \fBkgendesignerplugin\fR .\" Author: Richard Johnson .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 28-05-2014 .\" Manual: KDE Frameworks: KDesignerPlugin .\" Source: KDE Frameworks Frameworks 5.0 .\" Language: Spanish .\" .TH "\FBKGENDESIGNERPLUGI" "1" "28\-05\-2014" "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 "NOMBRE" kgendesignerplugin \- Genera complementos de elementos gr\('aficos para Qt(TM) Designer\&. .SH "SINOPSIS" .HP \w'\fBkgendesignerplugin\fR\ 'u \fBkgendesignerplugin\fR [\fIOPCIONES\fR...] \fIarchivo\fR .SH "DESCRIPCI\('ON" .PP Normalmente, los complementos de los widget personalizados para Qt(TM) Designer siguen un patr\('on est\('andar y las clases proporcionadas por el complemento proceden en su mayor\('ia de informaci\('on est\('atica junto con funciones para crear una instancia que normalmente solo es una simple llamada a un constructor\&. \fBkgendesignerplugin\fR permite a los desarrolladores de bibliotecas que proporcionan nuevos widgets crear dichos complementos sin tener que escribir todo el c\('odigo repetitivo asociado proporcionando un sencillo archivo de descripci\('on de estilos\&. .PP \fBkgendesignerplugin\fR elige valores predeterminados de manera sensata para la mayor\('ia de las preferencias, por lo que normalmente, solo es necesaria una configuraci\('on m\('inima\&. .SH "OPCIONES" .PP \fB\-o \fR\fB\fIarchivo\fR\fR .RS 4 Nombre del archivo C++ generado\&. Si no se proporciona, se utilizar\('a \fIstdout\fR will be used\&. .RE .PP \fB\-n \fR\fB\fInombre\-del\-complemento\fR\fR .RS 4 Se proporciona con fines de compatibilidad\&. Es el valor predeterminado para la opci\('on PluginName en el archivo de entrada\&. .RE .PP \fB\-g \fR\fB\fIgrupo\fR\fR .RS 4 Se proporciona con fines de compatibilidad\&. Es el valor predeterminado para la opci\('on DefaultGroup en el archivo de entrada\&. .RE .PP \fB\-\-author\fR .RS 4 Mostrar informaci\('on sobre el autor\&. .RE .PP \fB\-\-license\fR .RS 4 Mostrar informaci\('on sobre la licencia\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 Mostrar un breve texto de ayuda\&. .RE .PP \fB\-v , \-\-version\fR .RS 4 Mostrar informaci\('on sobre la versi\('on\&. .RE .SH "FORMATO DE ARCHIVO" .PP El archivo de entrada es de tipo INI (en concreto, est\('a en el formato que usa el framework KConfig) que describe un conjunto de widgets\&. Contiene una secci\('on [Global], que proporciona informaci\('on general sobre el complemento, y una secci\('on para cada widget que se debe incluir en el complemento\&. .PP La secci\('on [Global] puede tener las siguientes entradas: .PP \fIDefaultGroup\fR .RS 4 El valor predeterminado para la entrada \fIGroup\fR en las secciones de la clase (por omisi\('on: \(FoCustom\(Fc, a menos que se use la opci\('on \fB\-g\fR)\&. .RE .PP \fIIncludes\fR .RS 4 Una lista (separada por comas) de los archivos de cabecera necesarios (por omisi\('on est\('a vac\('ia)\&. Tenga en cuenta que los archivos de cabecera para los elementos gr\('aficos indicados posteriormente en el archivo no se deben incluir aqu\('i; en lugar de ello, esto es para archivos de cabecera especiales para el propio uso del complemento, como los de las clases que proporcionan vistas previas\&. .RE .PP \fIPluginName\fR .RS 4 El nombre de la clase de C++ principal del complemento (por omisi\('on, \(FoWidgetsPlugin\(Fc, a menos que se use la opci\('on \fB\-n\fR)\&. .RE .PP Cada clase debe tener su propia secci\('on [\fINombreDeClase\fR], que puede incluir las siguientes entradas: .PP \fICodeTemplate\fR .RS 4 El valor devuelto por la funci\('on codeTemplate() del complemento, que el Dise\(~nador de Qt(TM) ha marcado para \(Fouso futuro\(Fc (vac\('io por omisi\('on)\&. .RE .PP \fIConstructorArgs\fR .RS 4 Los argumentos a pasar al constructor de la clase indicada por ImplClass; deben estar entre par\('entesis (por omisi\('on: \(Fo(parent)\(Fc)\&. La \('unica variable cuya disponibilidad est\('a garantizada es \fIparent\fR, que es el QWidget padre pasado por Qt(TM) Designer\&. .sp Esta entrada se ignora si est\('a definido CreateWidget\&. .RE .PP \fICreateWidget\fR .RS 4 El c\('odigo necesario para crear una instancia del widget (por omisi\('on: usa new para crear una instancia de la clase indicada en la entrada ImplClass, pasando los argumentos indicados en ConstructorArgs)\&. Consulte las notas para ImplClass y ConstructorArgs\&. .RE .PP \fIDomXML\fR .RS 4 Una descripci\('on de la interfaz de usuario del widget en XML (por omisi\('on: la predeterminada que proporcionan las cabeceras del complemento de Qt(TM) Designer)\&. .RE .PP \fIGroup\fR .RS 4 El grupo bajo el que mostrar el widget en Qt(TM) Designer (por omisi\('on: el valor de la entrada \fIDefaultGroup\fR en la secci\('on [Global])\&. .RE .PP \fIIconName\fR .RS 4 El archivo de imagen o el nombre del icono est\('andar a usar como icono para este widget en la lista de widgets de Qt(TM) Designer (por omisi\('on, un archivo PNG con el nombre similar al nombre de la secci\('on, sin los dos puntos dobles, en el directorio \(Fopics\(Fc de un archivo de recursos compilado; como :/pics/Foo\&.png en la secci\('on [Foo], o :/pics/FooBar\&.png en la secci\('on [Foo::Bar])\&. .RE .PP \fIImplClass\fR .RS 4 La clase que se debe usar para crear una instancia del widget para que se pueda usar en Qt(TM) Designer (por omisi\('on, el nombre de la secci\('on)\&. Tenga en cuenta que no tiene por qu\('e ser la clase que se crear\('a en una aplicaci\('on final, que se define en DomXML\&. .sp Esta entrada se ignora si est\('a definido CreateWidget\&. .RE .PP \fIIncludeFile\fR .RS 4 El archivo de cabecera que se debe incluir para usar este widget (por omisi\('on, la versi\('on en min\('usculas del nombre de la secci\('on, sin dos puntos y terminado en \(Fo\&.h\(Fc\&. Por ejemplo, foo\&.h en la secci\('on [Foo], o foobar\&.h en la secci\('on [Foo::Bar]\&. .RE .PP \fIIsContainer\fR .RS 4 Determina si este widget puede contener otros widgets (por omisi\('on, false)\&. .RE .PP \fIToolTip\fR .RS 4 La ayuda emergente a mostrar cuando se sit\('ua el cursor sobre el widget en la lista de widgets de Qt(TM) Designer (por omisi\('on, el nombre de la secci\('on, terminado en \(Fo Widget\(Fc; por ejemplo, Foo Widget en la secci\('on [Foo])\&. .RE .PP \fIWhatsThis\fR .RS 4 El texto para \(Fo\(r?Qu\('e es esto?\(Fc asociado con el widget en Qt(TM) Designer (por omisi\('on, el nombre de la secci\('on terminado en \(Fo Widget\(Fc; por ejemplo, Foo Widget en la secci\('on [Foo])\&. .RE .SH "EJEMPLOS" .PP El archivo de descripci\('on m\('as sencillo ser\('ia parecido a: .sp .if n \{\ .RS 4 .\} .nf [Foo] ToolTip=Muestra foo [Bar] ToolTip=Editor de Bar .fi .if n \{\ .RE .\} .sp Note que cada clase debe tener al menos un conjunto de claves (en este ejemplo se ha usado ToolTip)\&. En caso contrario se ignorar\('a\&. .PP Normalmente querr\('a cambiar al menos el texto visible al usuario\&. Es decir, las entradas ToolTip, WhatsThis y Group\&. Adem\('as, definir un nombre para el complemento suele ser una buena idea para prevenir posibles colisiones de s\('imbolos y no confundir a los depuradores (tanto a la aplicaci\('on de depuraci\('on como a la persona que realiza la depuraci\('on): .sp .if n \{\ .RS 4 .\} .nf [Global] PluginName=FooWidgets DefaultGroup=Display [Foo] ToolTip=Muestra osos WhatsThis=Un elemento de imagen que muestra osos bailando [Bar] ToolTip=Editor de barras WhatsThis=Una interfaz de edici\('on de barras para los osos Group=Editing .fi .if n \{\ .RE .\} .PP Es posible que necesite archivos m\('as complejos si tiene clases dentro de espacios de nombres o necesita pasar opciones adicionales a los constructores\&. Por ejemplo: .sp .if n \{\ .RS 4 .\} .nf [Global] PluginName=FooWidgets DefaultGroup=Foo [Foo::Bar] ToolTip=Muestra barras WhatsThis=Un elemento gr\('afico que mustra barras de una forma particular 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 veces, los widgets especialmente complejos pueden necesitar una implementaci\('on especial para \(Foprevisualizar la clase\(Fc en Qt(TM) Designer\&. Puede ser una subclase del widget real que solo contiene alg\('un tipo de configuraci\('on adicional, o puede ser una implementaci\('on completamente distinta\&. .sp .if n \{\ .RS 4 .\} .nf [Global] Includes=foopreviews\&.h [FancyWidget] ImplClass=FancyWidgetPreview .fi .if n \{\ .RE .\} .sp .SH "CONSULTE TAMBI\('EN" .PP https://doc\&.qt\&.io/qt\-5/designer\-creating\-custom\-widgets\&.html .RS 4 La documentaci\('on del Dise\(~nador de Qt(TM) sobre c\('omo crear complementos para elementos gr\('aficos personalizados\&. .RE .SH "FALLOS" .PP Para informar sobre fallos use el \m[blue]\fBsistema de seguimiento de fallos de KDE\fR\m[]\&\s-2\u[1]\d\s+2 en lugar de enviar un mensaje directamente a los autores\&. .SH "AUTORES" .PP \fBRichard Johnson\fR <\&rjohnson@kde\&.org\&> .RS 4 Escribi\('o la documentaci\('on original .RE .PP \fBAlex Merry\fR <\&alexmerry@kde\&.org\&> .RS 4 Actualizaci\('on de la documentaci\('on para KDE Frameworks 5\&. .RE .SH "NOTAS" .IP " 1." 4 sistema de seguimiento de fallos de KDE .RS 4 \%https://bugs.kde.org .RE