NOMBRE¶

kgendesignerplugin - Genera complementos de elementos gráficos para Qt(TM) Designer.

SINOPSIS¶

kgendesignerplugin [OPCIONES...] archivo

DESCRIPCIÓN¶

Normalmente, los complementos de los widget personalizados para Qt(TM) Designer siguen un patrón estándar y las clases proporcionadas por el complemento proceden en su mayoría de información estática junto con funciones para crear una instancia que normalmente solo es una simple llamada a un constructor. kgendesignerplugin permite a los desarrolladores de bibliotecas que proporcionan nuevos widgets crear dichos complementos sin tener que escribir todo el código repetitivo asociado proporcionando un sencillo archivo de descripción de estilos.

kgendesignerplugin elige valores predeterminados de manera sensata para la mayoría de las preferencias, por lo que normalmente, solo es necesaria una configuración mínima.

OPCIONES¶

-o archivo

-n nombre-del-complemento

-g grupo

--author

--license

-h, --help

-v , --version

FORMATO DE ARCHIVO¶

El archivo de entrada es de tipo INI (en concreto, está en el formato que usa el framework KConfig) que describe un conjunto de widgets. Contiene una sección [Global], que proporciona información general sobre el complemento, y una sección para cada widget que se debe incluir en el complemento.

La sección [Global] puede tener las siguientes entradas:

DefaultGroup

Includes

PluginName

Cada clase debe tener su propia sección [NombreDeClase], que puede incluir las siguientes entradas:

CodeTemplate

ConstructorArgs

CreateWidget

DomXML

Group

IconName

ImplClass

IncludeFile

IsContainer

ToolTip

WhatsThis

EJEMPLOS¶

El archivo de descripción más sencillo sería parecido a:

[Foo]
ToolTip=Muestra foo
[Bar]
ToolTip=Editor de Bar


    

Note que cada clase debe tener al menos un conjunto de claves (en este ejemplo se ha usado ToolTip). En caso contrario se ignorará.

Normalmente querrá cambiar al menos el texto visible al usuario. Es decir, las entradas ToolTip, WhatsThis y Group. Además, definir un nombre para el complemento suele ser una buena idea para prevenir posibles colisiones de símbolos y no confundir a los depuradores (tanto a la aplicación de depuración como a la persona que realiza la depuración):

[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ón de barras para los osos
Group=Editing


    

Es posible que necesite archivos más complejos si tiene clases dentro de espacios de nombres o necesita pasar opciones adicionales a los constructores. Por ejemplo:

[Global]
PluginName=FooWidgets
DefaultGroup=Foo
[Foo::Bar]
ToolTip=Muestra barras
WhatsThis=Un elemento gráfico 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


    

A veces, los widgets especialmente complejos pueden necesitar una implementación especial para «previsualizar la clase» en Qt(TM) Designer. Puede ser una subclase del widget real que solo contiene algún tipo de configuración adicional, o puede ser una implementación completamente distinta.

[Global]
Includes=foopreviews.h
[FancyWidget]
ImplClass=FancyWidgetPreview


    

CONSULTE TAMBIÉN¶

https://doc.qt.io/qt-5/designer-creating-custom-widgets.html

FALLOS¶

Para informar sobre fallos use el sistema de seguimiento de fallos de KDE[1] en lugar de enviar un mensaje directamente a los autores.

AUTORES¶

Richard Johnson <rjohnson@kde.org>

Alex Merry <alexmerry@kde.org>

NOTAS¶

1.

sistema de seguimiento de fallos de KDE