NOME¶

kgendesignerplugin - Gera 'plugins' de elementos gráficos para o Qt(TM) Designer.

SINOPSE¶

kgendesignerplugin [OPÇÕES...] ficheiro

DESCRIÇÃO¶

Os 'plugins' de elementos gráficos personalizados do Qt(TM) Designer normalmente seguem um padrão normal, sendo que as classes oferecidas pelo 'plugin' fornecem na sua maioria alguma informação estática, em conjunto com a função para criar uma instância, a qual será normalmente uma simples chamada ao construtor. O kgendesignerplugin permite aos programadores das bibliotecas que fornecem elementos novos a criação de um desses 'plugins', sem ter de cria todo o código acessório associado, oferecendo um ficheiro de descrição do tipo INI.

O kgendesignerplugin escolhe opções predefinidas para a maioria das definições, pelo que normalmente é necessária apenas alguma configuração mínima.

OPÇÕES¶

-o ficheiro

-n nome-plugin

-g grupo

--author

--license

-h, --help

-v , --version

FORMATO DO FICHEIRO¶

O ficheiro de entrada é um ficheiro de configuração do tipo INI (para ser mais específico, está no formato suportado pela plataforma KConfig) que descreve um conjunto de itens gráficos. Contém uma secção [Global], que oferece informações gerais acerca do 'plugin', assim como uma secção para cada elemento que deverá ser incluído no 'plugin'.

A secção [Global] pode ter os seguintes elementos:

DefaultGroup

Includes

PluginName

Cada classe deverá ter a sua própria secção [ClassName], a qual poderá incluir os seguintes elementos:

CodeTemplate

ConstructorArgs

CreateWidget

DomXML

Group

IconName

ImplClass

IncludeFile

IsContainer

ToolTip

WhatsThis

EXEMPLOS¶

O ficheiro de descrição mais simples poderá ser algo do tipo

[XPTO]
ToolTip=Mostra elementos XPTO
[Bar]
ToolTip=Editor de barras


    

Repare que cada classe deverá ter pelo menos uma chave definida (ToolTip foi usado neste exemplo), caso contrário será ignorada.

Normalmente, irá querer alterar pelo menos o texto visível para o utilizador, o que corresponde aos itens ToolTip, WhatsThis e Group. Para além disso, definir o nome do 'plugin' poderá ser uma boa ideia para evitar possíveis conflitos de símbolos e para não confundir os depuradores (tanto a aplicação de depuração como a pessoa que efectua a mesma):

[Global]
PluginName=ElementosXPTO
DefaultGroup=Visualização
[XPTO]
ToolTip=Mostra ursos
WhatsThis=Um item de imagens que mostra ursos a dançar
[Ola]
ToolTip=Editor de barras
WhatsThis=Uma interface de edição para barras para ursos
Group=Edição


    

Poderão ser necessários ficheiros mais complexos, caso tenha classes com espaços de nomes ou opções extra que seja necessário passar aos construtores, como por exemplo:

[Global]
PluginName=ElementosXpto
DefaultGroup=XPTO
[XPTO::Ola]
ToolTip=Mostra barras
WhatsThis=Um elemento que mostra elementos de uma determinada forma
IncludeFile=xpto/ola.h
IconName=:/antevisoes/ola.png
[XPTO::Ola2]
IncludeFile=xpto/ola2.h
ConstructorArgs=(XPTO::Ola2::UmaOpcao, parent)
Group=XPTO (Especial)
IsContainer=true
IconName=:/antevisoes/ola2.png


    

Em alguns casos, os itens gráficos especialmente complexos poderão necessitar de uma implementação de uma "classe de antevisão" para usar no Qt(TM) Designer; esta poderá ser uma sub-classe do elemento real que simplesmente faz mais algumas configurações adicionais, ou poderá então ser uma implementação completamente diferente.

[Global]
Includes=xpto-antevisoes.h
[ElementoBonito]
ImplClass=ElementoBonitoAntevisao


    

VEJA TAMBÉM¶

http://qt-project.org/doc/qt-5/designer-creating-custom-widgets.html

PROBLEMAS¶

Use por favor o bugs.kde.org[1] para comunicar os erros; não os envie directamente para os autores por e-mail.

AUTORES¶

Richard Johnson <rjohnson@kde.org>

Alex Merry <alexmerry@kde.org>

NOTAS¶

1.

bugs.kde.org