<!-- <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
"dtd/kdex.dtd"
>-->
<chapter id="advanced-quanta">
<title
>Recursos Avançados do &quanta;</title>

<para
>Este capítulo introduz os recursos avançados do &quanta;.</para>

<!-- 
<sect1 id="kommander">
<title
>Using &kommander; with &quanta;</title>
<para
>Kommander by Marc Britton.</para>
</sect1>


&debugging-quanta;
-->

<sect1 id="tag-files">
<title
>Arquivos de Tag &quanta;</title>

<para
>O &quanta; usa arquivos de tag para definir as várias ações que estão disponíveis para a associação na barra de ferramentas. Estes arquivos de tag podem definir uma tag simples sem nenhum atributo ou definir uma caixa de diálogo de tag que lembrará todos os atributos disponíveis para você de modo que você possa simplesmente preencher as lacunas.</para>

<important
> <para
>Espaços em branco não afetam em nada, mas fique atento aos caracteres &amp; e &lt;. Eles devem ser substituídos por &amp;amp; e &amp;lt; respectivamente em todos os arquivos de recurso do &quanta; baseados em &XML;. Isto não causará um travamento, mas você terá partes de seu trabalho perdidas se você esquecer de observar este aspecto.</para
> </important>

<sect2 id="tag-file-structure">
<title
>Estrutura do Arquivo de Tag</title>

<sect3>
<title
>Atributos</title>

<para
>Entradas possíveis para o tipo de atributo da tag attr: Para obter uma lista dos possíveis tipos, eu fiz o seguinte nos diretórios de tag: <userinput
><command
>grep</command
> <option
>-h</option
> <option
>type</option
>= <parameter
>*.tag</parameter
> |<command
>sed</command
> <option
>-e</option
> <parameter
>'s/^.*type=\"\([a-z]*\).*/\1/'</parameter
>| <command
>sort</command
> |<command
>uniq</command
></userinput
> </para>
<para
>Estes são os tipos de itens de diálogo da tag:</para>

<simplelist
><member
>check</member
> <member
>color</member
> <member
>input</member
> <member
>list</member
> <member
>text</member
> <member
>url</member
> </simplelist>

<para
>Estes são os tipos de argumentos dentro de tags de função php, agradeça a Andras se estes são formulários muito bonitos e flexíveis e os anteriores são palavras chave:</para>

<simplelist
> <member
>array</member
> <member
>bool</member
> <member
>boolean</member
> <member
>char</member
> <member
>constant</member
> <member
>flags</member
> <member
>float</member
> <member
>function</member
> <member
>int</member
> <member
>long</member
> <member
>mixed</member
> <member
>number</member
> <member
>object</member
> <member
>resource</member
> <member
>resoure</member
> <member
>string</member
> </simplelist>

<para
>A definição da tag tem os seguintes atributos opcionais:</para>

<variablelist
> <varlistentry
> <term
><sgmltag class="attribute"
>hasScript</sgmltag
></term
> <listitem
><para
><sgmltag class="attvalue"
>1</sgmltag
> se eventos/scripts comuns podem ser associados com esta tag (&eg; <sgmltag class="attribute"
>onclick</sgmltag
> )</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>hasCore</sgmltag
></term
> <listitem
><para
><sgmltag class="attvalue"
>1</sgmltag
> se atributos comum de núcleo estão presentes (<sgmltag class="attribute"
>id</sgmltag
>, <sgmltag class="attribute"
>class</sgmltag
>, &etc;)</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>hasI18n</sgmltag
></term
> <listitem
><para
><sgmltag class="attvalue"
>1</sgmltag
> se atributos i18n comuns estão presentes (<sgmltag class="attribute"
>lang</sgmltag
>, <sgmltag class="attribute"
>dir</sgmltag
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>single</sgmltag
></term
> <listitem
><para
><sgmltag class="attvalue"
>1</sgmltag
> se é uma tag simples (&eg; <sgmltag class="starttag"
>hr</sgmltag
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>optional</sgmltag
></term
> <listitem
><para
><sgmltag class="attvalue"
>1</sgmltag
> se é uma tag opcional (&eg; <sgmltag class="starttag"
>colgroup</sgmltag
>)</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>returnType</sgmltag
></term
> <listitem
><para
>para linguagens de script, o tipo de retorno da função se algun (&eg; <sgmltag class="attribute"
>inteiro</sgmltag
>)</para
></listitem
> </varlistentry
> </variablelist>

<para
>A definição <sgmltag class="starttag"
>attr</sgmltag
> pode ter os seguintes atributos:</para>

<variablelist
> <varlistentry
> <term
><sgmltag class="attribute"
>defaultValue</sgmltag
></term
> <listitem
><para
>o valor padrão para a tag</para
></listitem
> </varlistentry
> <varlistentry
> <term
><sgmltag class="attribute"
>status</sgmltag
></term
> <listitem
><para
>pode ser <sgmltag class="attvalue"
>optional</sgmltag
>, <sgmltag class="attvalue"
>required</sgmltag
>, <sgmltag class="attvalue"
>implied</sgmltag
></para
></listitem
> </varlistentry
> </variablelist>

</sect3>
<sect3>
<sect3info>
<author
> <firstname
></firstname
> <surname
></surname
> </author>
</sect3info>
<title
>Funções de Linguagem de Script</title>

<para
>Para funções de linguagem de script, arquivos de definição de tag como:</para>

<informalexample
> <literallayout>
<markup>

</markup>
</literallayout
> </informalexample>

<para
>Itens entre [] serão substituídos. argumento1 acima é necessário e o argumento2 é opcional.</para>

<para
>Um arquivo de tag que você tenha um diálogo de edição deve parecer com este:</para>

<informalexample
> <programlisting>
<markup>

</markup>
</programlisting
> </informalexample>

<para
><sgmltag class="starttag"
>text</sgmltag
><sgmltag class="endtag"
>text</sgmltag
> define um texto resumido descritivo para o objeto.</para>

<para
><sgmltag class="emptytag"
>textlocation</sgmltag
> define o layout de linha e coluna da tag <sgmltag class="starttag"
>text</sgmltag
>. </para>
<para
> <sgmltag class="starttag"
>tooltip</sgmltag
><sgmltag class="endtag"
>tooltip</sgmltag
> é a descrição de texto flutuante para um usuário.</para>
<para
><sgmltag class="emptytag"
>location</sgmltag
> define a localização do objeto para aquele atributo. </para>
<para
>Todos os atributos devem ser enumerados no arquivo de tag. Se você não quiser que apareça numa aba de diálogo, apenas omita a tag <sgmltag class="starttag"
>location</sgmltag
>, &eg; <sgmltag class="starttag"
>attr</sgmltag
><sgmltag class="endtag"
>attr</sgmltag
> </para>
</sect3>
</sect2>
</sect1>

</chapter>

