<?xml version="1.0" ?>
<!DOCTYPE refentry PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % Portuguese "INCLUDE">
]>

<refentry lang="&language;">
<refentryinfo>
<title
>Ferramenta de Programação</title>

<author
><firstname
>Ian</firstname
> <othername
>Reinhart</othername
> <surname
>Geiser</surname
> <affiliation
> <address
> <email
>geiseri@kde.org</email>
</address>
</affiliation>
</author>

<date
>2006-06-01</date>
<productname
>Ambiente de Trabalho K</productname>
</refentryinfo>

<refmeta>
<refentrytitle>
<command
>makekdewidgets</command>
</refentrytitle>
<manvolnum
>1</manvolnum>
</refmeta>

<refnamediv>
<refname
>makekdewidgets</refname>
<refpurpose
>Cria 'plugins' de elementos gráficos do &Qt; a partir de um ficheiro de descrição do estilo INI. </refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis
><command
>makekdewidgets</command
> <arg
>opções do &Qt;</arg
> <arg
>opções do &kde;</arg
> <arg choice="plain"
><replaceable
>ficheiro</replaceable
></arg
> </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
<title
>Descrição</title>
<para
>O <command
>makekdewidgets</command
> cria 'plugins' de elementos gráficos do &Qt; a partir de um ficheiro de descrição do estilo INI. </para>
</refsect1>

<refsect1>
<title
>Opções</title>

<para>
<variablelist>
<title
><emphasis role="bold"
>Argumentos:</emphasis
></title>
<varlistentry>
<term>
<replaceable
>ficheiro</replaceable>
</term>
<listitem>
<para
>Ficheiro de entrada</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções:</emphasis
></title>
<varlistentry>
<term>
<option
>-o &lt;ficheiro&gt;</option>
</term>
<listitem>
<para
>Ficheiro de resultado</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option
>-n &lt;nome do 'plugin'&gt;</option>
</term>
<listitem>
<para
>O nome da classe do 'plugin' a gerar [WidgetsPlugin]</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option
>-g &lt;grupo&gt;</option>
</term>
<listitem>
<para
>O nome do grupo predefinido de elementos onde mostrar no desenhador [Custom]</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<option
>-p &lt;pasta de imagens&gt;</option>
</term>
<listitem>
<para
>Incorporar as imagens de uma pasta de origem</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções genéricas:</emphasis
></title>

<varlistentry>
<term>
<option
>--help</option>
</term>
<listitem>
<para
>Mostra a ajuda acerca das opções.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-qt</option>
</term>
<listitem>
<para
>Mostrar as opções específicas do &Qt;</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-kde</option>
</term>
<listitem>
<para
>Mostra opções específicas do &kde;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--help-all</option>
</term>
<listitem>
<para
>Mostrar todas as opções</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--author</option>
</term>
<listitem>
<para
>Mostra informações sobre o autor.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>-v, --version</option>
</term>
<listitem>
<para
>Mostra a versão.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--license</option>
</term>
<listitem>
<para
>Mostra informações sobre a licença</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções do &kde;:</emphasis
></title>

<varlistentry>
<term>
<option
>--caption &lt;título&gt;</option>
</term>
<listitem>
<para
>utiliza o 'caption' como o título da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--icon &lt;ícone&gt;</option>
</term>
<listitem>
<para
>utiliza o 'icon' como o ícone da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--miniicon &lt;ícone&gt;</option>
</term>
<listitem>
<para
>utiliza o 'icon' como o ícone da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--config &lt;ficheiro&gt;</option>
</term>
<listitem>
<para
>Usar o ficheiro de configuração alternativo</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--dcopserver &lt;servidor&gt;</option>
</term>
<listitem>
<para
>Usar o servidor de &DCOP; indicado pelo 'servidor'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--nocrashhandler</option>
</term>
<listitem>
<para
>Desactivar o tratamento de estoiros para obter os ficheiros 'core'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--waitforwm</option>
</term>
<listitem>
<para
>Espera um gestor de janelas compatível com WM_NET</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--style &lt;estilo&gt;</option>
</term>
<listitem>
<para
>Configura o estilo da &GUI; da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--geometry &lt;geometria&gt;</option>
</term>
<listitem>
<para
>Define a geometria do cliente da janela principal - veja o 'man X' para obter o formato dos argumentos</para>
</listitem>
</varlistentry>
</variablelist>
</para>

<para>
<variablelist>
<title
><emphasis role="bold"
>Opções do &Qt;:</emphasis
></title>

<varlistentry>
<term>
<option
>--display &lt;nome-ecrã&gt;</option>
</term>
<listitem>
<para
>Utilizar o ecrã do servidor de X 'displayname'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--session &lt;id-sessão&gt;</option>
</term>
<listitem>
<para
>Restaurar a aplicação com o 'sessionId' dado</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--cmap</option>
</term>
<listitem>
<para
>Faz com que a aplicação instale um mapa de cores privado num ecrã de 8 bits</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--ncols &lt;quantidade&gt;</option>
</term>
<listitem>
<para
>Limita o número de cores reservadas no cubo de cores para um ecrã de 8 bits, se a aplicação estiver a usar a especificações de cores QApplication::ManyColor</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--nograb</option>
</term>
<listitem>
<para
>Diz ao &Qt; para nunca capturar o rato ou o teclado</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--sync</option>
</term>
<listitem>
<para
>Muda para o modo síncrono, para fins de depuração</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--fn, --font &lt;nome-tipo-letra&gt;</option>
</term>
<listitem>
<para
>Define o tipo de letra da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--bg, --background &lt;cor&gt;</option>
</term>
<listitem>
<para
>Define a cor de fundo por omissão, bem como uma paleta da aplicação (os tons claros e escuros são calculados)</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--fg, --foreground &lt;cor&gt;</option>
</term>
<listitem>
<para
>Altera a cor do texto por omissão</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--btn, --button &lt;cor&gt;</option>
</term>
<listitem>
<para
>Altera a cor dos botões por omissão</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--name &lt;nome&gt;</option>
</term>
<listitem>
<para
>Define o nome da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--title &lt;título&gt;</option>
</term>
<listitem>
<para
>Define o título (legenda) da aplicação</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--visual TrueColor</option>
</term>
<listitem>
<para
>Obriga a aplicação a usar um visual TrueColor num ecrã de 8 bits</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--inputstyle &lt;estilo-entrada&gt;</option>
</term>
<listitem>
<para
>Define o estilo de introdução de dados do XIM (X Input Method). Os valores possíveis são 'onthespot', 'overthespot', 'offthespot' e 'root'</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--im &lt;servidor de XIM&gt;</option>
</term>
<listitem>
<para
>Define o servidor de XIM</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--noxim</option>
</term>
<listitem>
<para
>Desactiva o XIM</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<option
>--reverse</option>
</term>
<listitem>
<para
>Inverte por completo a disposição dos elementos gráficos</para>
</listitem>
</varlistentry>
</variablelist>
</para>

</refsect1>

<refsect1>
<title
>Veja Também</title>
<variablelist>
<varlistentry>
<term>
<option
>http://developer.kde.org</option>
</term>
<listitem>
<para
>Página Web do Canto do Programador do &kde;</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1>
<title
>Problemas</title>
<para
>Use por favor o <ulink url="http://bugs.kde.org"
>bugs.kde.org</ulink
> para comunicar os erros; não os envie directamente para os autores por e-mail.</para>
</refsect1>

</refentry>
